Difference between revisions of "SAM"
Jump to navigation
Jump to search
Using
BrettViren (talk | contribs) |
BrettViren (talk | contribs) |
||
Line 10: | Line 10: | ||
* [https://cdcvs.fnal.gov/redmine/projects/sam-web/wiki redmine wiki] | * [https://cdcvs.fnal.gov/redmine/projects/sam-web/wiki redmine wiki] | ||
− | = Client = | + | == Sam Web Client == |
Access to SAM Web is made easier through the SAM Web Client client-side Python module and command line interface tool called <code>samweb</code>. | Access to SAM Web is made easier through the SAM Web Client client-side Python module and command line interface tool called <code>samweb</code>. | ||
Line 17: | Line 17: | ||
* [https://cdcvs.fnal.gov/redmine/projects/sam-main/wiki/Sam_web_client_Command_Reference command ref] | * [https://cdcvs.fnal.gov/redmine/projects/sam-main/wiki/Sam_web_client_Command_Reference command ref] | ||
− | == Installation == | + | === Installation of sam-web-client package === |
− | * On fnal.gov machines, it | + | * On fnal.gov machines, it should be [https://cdcvs.fnal.gov/redmine/projects/sam/wiki/User_Guide_for_SAM#Setting-up-samweb-Tools available under UPS] |
* To install see [https://github.com/DUNE/sam-web-client/blob/master/README.md these instructions] | * To install see [https://github.com/DUNE/sam-web-client/blob/master/README.md these instructions] | ||
+ | |||
+ | === Using <code>samweb</code> === | ||
+ | |||
+ | Command line help | ||
+ | |||
+ | samweb | ||
+ | |||
+ | Locate a file's URL: | ||
+ | |||
+ | $ samweb -e lbne get-file-access-url lbne_r006837_sr01_20160112T213253.root | ||
+ | gsiftp://fndca1.fnal.gov:2811/pnfs/fnal.gov/usr/lbne/test-data/lbne/raw/00/18/90/51/lbne_r006837_sr01_20160112T213253.root | ||
+ | |||
+ | Locate a file: | ||
+ | |||
+ | $ samweb -e lbne locate-file lbne_r006837_sr01_20160112T213253.root | ||
+ | enstore:/pnfs/lbne/test-data/lbne/raw/00/18/90/51(602@vpe776) | ||
+ | |||
+ | Access metadata: | ||
+ | |||
+ | $ samweb -e lbne get-metadata lbne_r006837_sr01_20160112T213253.root | ||
+ | File Name: lbne_r006837_sr01_20160112T213253.root | ||
+ | File Id: 189051 | ||
+ | Create Date: 2016-01-12T22:09:17+00:00 | ||
+ | User: dunepro | ||
+ | Update Date: 2016-01-12T22:28:26+00:00 | ||
+ | Update User: lbnepro | ||
+ | File Type: test-data | ||
+ | File Format: root | ||
+ | File Size: 1762859968 | ||
+ | Checksum: enstore:1713616759 | ||
+ | Content Status: good | ||
+ | Group: lbne | ||
+ | Data Tier: raw | ||
+ | Application: art daqag v00_00_01 | ||
+ | Event Count: 280695 | ||
+ | First Event: 1 | ||
+ | Last Event: 280695 | ||
+ | Start Time: 2016-01-12T21:32:16+00:00 | ||
+ | End Time: 2016-01-12T21:55:46+00:00 | ||
+ | lbne_data.detector_type: 35t:penn01:rce13:rce09:rce08:rce07:rce06:rce05:rce04:rce03:rce02:rce01:rce00:rce10:rce11:rce15:rce12:rce14 | ||
+ | lbne_data.name: Test | ||
+ | lbne_data.run_mode: rces_and_ssps_and_ptb | ||
+ | Runs: 6837 (test) |
Revision as of 18:20, 13 January 2016
SAM (Sequential Access via Metadata) is a system by and at Fermilab for providing a database that ties metadata to file locations, allows file set definition and query, and other features. See also Metadata.
Contents
SAM Web
SAM may be accessed via an HTTP API called SAM Web Services.
Some information resources about SAM Web
Sam Web Client
Access to SAM Web is made easier through the SAM Web Client client-side Python module and command line interface tool called samweb
.
Installation of sam-web-client package
- On fnal.gov machines, it should be available under UPS
- To install see these instructions
Using samweb
Command line help
samweb
Locate a file's URL:
$ samweb -e lbne get-file-access-url lbne_r006837_sr01_20160112T213253.root gsiftp://fndca1.fnal.gov:2811/pnfs/fnal.gov/usr/lbne/test-data/lbne/raw/00/18/90/51/lbne_r006837_sr01_20160112T213253.root
Locate a file:
$ samweb -e lbne locate-file lbne_r006837_sr01_20160112T213253.root enstore:/pnfs/lbne/test-data/lbne/raw/00/18/90/51(602@vpe776)
Access metadata:
$ samweb -e lbne get-metadata lbne_r006837_sr01_20160112T213253.root File Name: lbne_r006837_sr01_20160112T213253.root File Id: 189051 Create Date: 2016-01-12T22:09:17+00:00 User: dunepro Update Date: 2016-01-12T22:28:26+00:00 Update User: lbnepro File Type: test-data File Format: root File Size: 1762859968 Checksum: enstore:1713616759 Content Status: good Group: lbne Data Tier: raw Application: art daqag v00_00_01 Event Count: 280695 First Event: 1 Last Event: 280695 Start Time: 2016-01-12T21:32:16+00:00 End Time: 2016-01-12T21:55:46+00:00 lbne_data.detector_type: 35t:penn01:rce13:rce09:rce08:rce07:rce06:rce05:rce04:rce03:rce02:rce01:rce00:rce10:rce11:rce15:rce12:rce14 lbne_data.name: Test lbne_data.run_mode: rces_and_ssps_and_ptb Runs: 6837 (test)