diff --git a/CREST.md b/CREST.md index 343de00c1afc39bf16ead285a996c2cdb504833a..b157592734683724300ceef3f0cc25a7b0a6f4db 100644 --- a/CREST.md +++ b/CREST.md @@ -197,8 +197,8 @@ curl "http://crest-j23.cern.ch:8080/api-v5.0/iovs/size?tagname=LARBadChannelsMis In order to retrieve a payload you need a `hash` key as described in the step above. Each payload has a certain amount of metadata associated. You can retrieve the metadata and the payload in the following way: ```shell -crestCmd get payloadMetaInfo -w bbb931ebb48c6713fe07bcef8d6d7c259552ae104276975f85559ce2b7892b15 -crestCmd get payload -w bbb931ebb48c6713fe07bcef8d6d7c259552ae104276975f85559ce2b7892b15 +crestCmd get payloadMetaInfo -w be706ca483373487286dfef4bf5d5481458b536d08077aab237dbed707374edb +crestCmd get payload -w be706ca483373487286dfef4bf5d5481458b536d08077aab237dbed707374edb ``` In general the payload is a JSON file containing the conditions data for a given `Tag`. This is in any case not a mandatory constraint for CREST server, you could imagine that your payload is for example an image or a ROOT file. However, for a better Athena integration we have been using a standard JSON format to migrate existing COOL data. @@ -248,16 +248,16 @@ This part of the examples covers simple methods to store data in CREST. Be aware We provide the examples in a precise order to have a complete overview of the steps starting from a `Global Tag`. In general system experts will only deal with `Tags`, as the `Global Tag` are normally administered by `Conditions Coordinators`. ### Create a Global Tag -To create a `Global Tag` you can use the following command: +To create a `Global Tag` you can use the following command (replace USERX with your name): ```shell -crestCmd create globalTag --tagName TEST-GT-CREST-01 --description test --release 1 --scenario test --type t --workflow T --validity 0 +crestCmd create globalTag --tagName TEST-USERX-GT-CREST-01 --description test --release 1 --scenario test --type t --workflow T --validity 0 ``` When using `curl` you should create a json file with that content: ```shell cat > gt.json << EOF { "description": "test", - "name": "TEST-GT-CREST-02", + "name": "TEST-USERX-GT-CREST-02", "release": "1", "scenario": "test", "type": "t", @@ -270,7 +270,7 @@ curl -X POST http://crest-j23.cern.ch:8080/api-v5.0/globaltags \ -H "Content-Type: application/json" \ --data-binary @gt.json # Verify that the global tag is created -curl -X GET http://crest-j23.cern.ch:8080/api-v5.0/globaltags/TEST-GT-CREST-02 +curl -X GET http://crest-j23.cern.ch:8080/api-v5.0/globaltags/TEST-USERX-GT-CREST-01 ``` Later on you will see how you can remove your tests to clean up what you did. @@ -285,7 +285,7 @@ We are not going to provide here the `curl` example, but you can obviously do so ### Create Global Tag mapping Since we have both a `Tag` and a `Global Tag` we can as well emulate what the `Conditions Coordination` would do, and associate our tag to the global tag. ```shell -crestCmd create globalTagMap --globalTagName TEST-GT-CREST-01 --tagName TEST-USERX-LARAlign-01 --label /LAR/Align --record None +crestCmd create globalTagMap --globalTagName TEST-USERX-GT-CREST-01 --tagName TEST-USERX-LARAlign-01 --label /LAR/Align --record None ``` You can check what you did using the commands from the previous section. @@ -313,7 +313,7 @@ Once your tests are over, it would be nice if you could clean your data (if they ### Remove the Tag from the Global Tag To detach a `Tag` from its `Global Tag` you can use: ```shell -crestCmd remove tagFromGlobalTagMap -n TEST-USERX-LARAlign-01 -g TEST-GT-CREST-01 -l "/LAR/Align" +crestCmd remove tagFromGlobalTagMap -n TEST-USERX-LARAlign-01 -g TEST-USERX-GT-CREST-01 -l "/LAR/Align" ``` You need to specify all parameters. @@ -328,8 +328,8 @@ You can verify that the tag is not anymore available. ### Remove a Global Tag If a `Global Tag` is not present in any association with some `Tag`, you may also remove it: ```shell -crestCmd remove globalTag -n TEST-GT-CREST-01 -# If you used the curl command for global tag creation you may also remove TEST-GT-CREST-02 +crestCmd remove globalTag -n TEST-USERX-GT-CREST-02 +# If you used the curl command for global tag creation you may also remove TEST-USERX-GT-CREST-02 ```