Difference between revisions of "DIRAC new user checklist"

Revision as of 13:57, 3 August 2015

Return to the Quick Guide to DIRAC.

First steps

• I have a grid certificate;
• I have installed my grid certificate in my browser;
• I have joined a VO.
• I have accessed the Imperial DIRAC server;
• I have joined the Imperial DIRAC mailing list.

First steps - testing

• Viewing your certificate details: visit this website with your browser. You should see your grid certificate details displayed.

• Accessing the Imperial DIRAC server: access https://dirac.gridpp.ac.uk with your browser. If your grid certificate has been successfully installed in your browser, your browser should ask you to identify yourself with the certificate in question. You will then see the Imperial DIRAC server homepage. Check the bottom right-hand corner - if you can only see Visitor and not your username and DN, you are (or rather, your certificate is) not registered with the Imperial DIRAC server - please contact Imperial Dirac Support. Note that there is a couple of hours (< 24) delay after joining a VO, before the dirac server recognizes you.

• Joining the Imperial DIRAC mailing list: once you have subscribed, you should be able to view the subscribers list from the list homepage and see that you're on it.

Your Virtual Organisation

• I have joined a supported Virtual Organisation (VO);
• I have checked that my VO is supported by the Imperial DIRAC server;
• I have accessed the Imperial DIRAC server as a member of my VO.

Your Virtual Organisation - testing

• Joining a VO: You should receive a confirmation email with the subject [VOMS Admin] Your vo membership request for VO [VO name] has been approved. - where [VO name] is the name of the VO - within 24 hours. You may be asked to confirm the request - make sure you don't accidentally cancel the request.
• Accessing the Imperial DIRAC server as a VO member: access https://dirac.grid.hep.ph.ic.ac.uk:8443 with your browser. Click on the drop-down menu displaying Visitor. You should be able to select your VO by clicking on the name. If not, contact lcg-site-admin@imperial.ac.uk.

DIRAC client installation

• I have converted my grid certificate into a certificate file and key file and put these in my ~/.globus directory;
• I can communicate with the DIRAC configuration server from my local system;
• I have installed a DIRAC client on my local system (following the instructions here);
• I have generated a proxy with my grid certificate (following the instructions here).

DIRAC client installation - testing

• Grid certificate conversion and installation: when logged on to your local system, ls ~/.globus should return usercert.pem and userkey.pem;
• Contacting the configuration server: when logged on to your local system, nc -v 146.179.247.169 9135 should work. If not, contact your system administrator and/or check your firewall settings.
• DIRAC client installation: the installation procedure should run with no error messages. Upon sourcing . $DIRACDIR/bashrc, you should be able to run (and tab-complete) the dirac-* commands;
• Proxy generation with DIRAC: if the installation has been successful, upon entering the DIRAC proxy generation command:

$ dirac-proxy-init -g northgrid_user -M

you should asked to enter your certificate password and then receive a message similar to the following (the values in square brackets will vary):

Generating proxy... 
Enter Certificate password:
Uploading proxy for gridpp_user... 

Proxy generated: 
subject      : [your grid certificate DN]
issuer       : [your grid certificate DN]
identity     : [your grid certificate DN]
timeleft     : [reminaing time]
DIRAC group  : northgrid_user
path         : /tmp/x509up_u500
username     : [your username]
properties   : NormalUser
VOMS         : True
VOMS fqan    : ['/[VO name]'] 

Proxies uploaded: 
 DN                                                           | Group             | Until (GMT) 
 [your DN]                                                    | northgrid_user    | [time left on proxy] 

The official DIRAC tutorials

The "official" DIRAC tutorials can be found on their GitHub wiki here. Tutorials 1-3 are covered by the steps above, so we will start at number 4.

Please note that these tutorials are based on a different DIRAC instance, and so details like Storage Elements will differ from those available on the Imperial DIRAC instance. Please ask the Imperial DIRAC support team about which SEs are supported by your VO and adjust the commands accordingly.

Tutorial 4. Job management basics

After following the tutorial, I can:

• Submit a simple job;
• Query the status of my simple job;
• Retrieve the output of my simple job;
• Submit and retrieve the output from a job that runs a custom script using the InputSandbox.

Tutorial 5. Data management basics

After following the tutorial, I can:

• List the Storage Elements (SEs) available to me through my VO;
• Upload a local file to my VO's user area at /$VO_NAME/user/$SUERNAME_FIRST_INITIAL/$USERNAME/;
• Download the file from the SE to $WORKINGDIR/tmp;
• Create a replica of the file on another SE;
• Remove the replica of the file;
• Remove the file from the grid.

Tutorial 6. File catalog basics

After following the tutorial, I can:

• Start the DIRAC File Catalog interface;
• Move to my user directory in the DFC, /$VO_NAME/user/$USERNAME_FIRST_INITIAL/$USERNAME/;
• Create a new test directory in my user directory;
• Upload a local file to this new directory;
• Get the size of the file from it's Logical File Name (LFN);
• Remove the file;
• Remove the test directory;
• Retrieve my DIRAC identity information.

The official DIRAC tutorials - testing

Tutorial 4. Job management basics - testing

• Simple job submission: your simple job - performing ls -ltr on the worker node - should run successfully. You can retrieve the output using dirac-wms-job-get-output [job ID], and view the $WORKINGDIR/[job ID]/StdOut file.
• Submitting a script with the InputSandbox: your job runs the script uploaded with the InputSandbox runs successfully. You can retrieve the job output and view any files that you requested be retrieved with OutputSandbox in the $WORKINGDIR/[job ID] directory.

Tutorial 5. Data management basics - testing

• File upload, download and removal: you can perform the steps listed above without generating any errors.

Tutorial 6. File catalog basics - testing

• File upload, download and removal with the File Catalog Client: you can perform the steps listed above without generating any errors.