Difference between revisions of "SAM"

From DUNE
Jump to navigation Jump to search
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 is [https://cdcvs.fnal.gov/redmine/projects/sam/wiki/User_Guide_for_SAM#Setting-up-samweb-Tools available under UPS]  
+
* 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.

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

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)