Skip to content

Commit 0b0601d

Browse files
Added some SAM locate-file and get-file-access-url info
1 parent 77aecd9 commit 0b0601d

1 file changed

Lines changed: 9 additions & 1 deletion

File tree

icaruscode_wiki/samples/datafiles.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,15 @@ You can use `samweb` (`setup sam_web_client` on a GPVM) to locate decode files a
2525
reports the "decoded" raw files (ready for LArSoft reconstruction or event display)
2626
* all available metadata to select on can be seen by picking a file and asking `get-metadata`;
2727
for example: `samweb get-metadata data_dl14_run4811_174_20210209T091842_20210209T135806-stage0-b12a3477-ad55-49e6-8673-152a25892ced.root`
28-
* `samweb locate-file filename` where filename is a decoded file
28+
* `samweb locate-file filename` where filename is a decoded file; it prints a list of locations where SAM believes the file can be accessed. As an URL, it is usually useless.
29+
* SAM trusts what it was told; if a file has been (re)moved or if the information in SAM was wrong from the beginning, you'll just get a wrong location
30+
* different "protocols" in the locations have different meanings:
31+
* `dcache:`: the file is supposed to be on the dCache disk, ready to access.
32+
* `enstore:`: the file is supposed to be on tape; it _might_ be also on the path specified on dCache, but on the other end what is there might be a placeholder that when accessed may trigger the file retrieval (which may take hours) and likely a timeout which sometimes ends with a scary "I/O error". Files can't be used directly from tape: they need to be cached on a disk (→ dCache).
33+
* `cnafdisk:`: the file is stored at INFN Centro Nazionale Analisi Fotogrammi (CNAF) facility (get the literal translation for a laugh)
34+
* `samweb get-file-access-url --schema schema filename` gives a URL that instead can often be actually used. The `schema` options include among others:
35+
* `root`: returns a URL good for XRootD access (get access to the ROOT file directly from dCache or whichever _disk_ that is in)
36+
* `https`: useful to copy the file with `ifdh cp` (especially if the file is stored at CNAF).
2937

3038

3139
### Examples of metadata

0 commit comments

Comments
 (0)