Difference between revisions of "DIRAC new user checklist"
From GridPP Wiki
(→First steps) |
|||
| (14 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | This page has moved to the [https://github.com/gridpp/user-guides/blob/master/dirac-first-steps/checklist.md GridPP GitHub site]. Please follow the instructions there and leave feedback via the [https://github.com/gridpp/user-guides/issues GitHub Issue system] - thanks! | ||
| + | |||
| + | |||
| + | |||
''Return to the [[Quick Guide to Dirac|Quick Guide to DIRAC]]''. | ''Return to the [[Quick Guide to Dirac|Quick Guide to DIRAC]]''. | ||
| + | |||
| + | <!-- | ||
==First steps== | ==First steps== | ||
* I have a [[Grid user crash course#Getting_a_grid_certificate|grid certificate]]; | * I have a [[Grid user crash course#Getting_a_grid_certificate|grid certificate]]; | ||
* I have [http://ngs.ac.uk/ukca/certificates/certimport installed my grid certificate in my browser]; | * I have [http://ngs.ac.uk/ukca/certificates/certimport installed my grid certificate in my browser]; | ||
| − | * I have | + | * I have joined a VO. |
| − | * I have accessed the [https://dirac. | + | * I have accessed the [https://dirac.gridpp.ac.uk Imperial DIRAC server]; |
* I have joined the [https://mailman.ic.ac.uk/mailman/listinfo/gridpp-dirac-users Imperial DIRAC mailing list]. | * I have joined the [https://mailman.ic.ac.uk/mailman/listinfo/gridpp-dirac-users Imperial DIRAC mailing list]. | ||
==First steps - testing== | ==First steps - testing== | ||
| − | * '''Accessing the Imperial DIRAC server''': access https://dirac. | + | * '''Viewing your certificate details''': visit [https://portal.ca.grid-support.ac.uk/caportal/cert_owner 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 [mailto:lcg-site-admin@imperial.ac.uk 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 [https://mailman.ic.ac.uk/mailman/roster/gridpp-dirac-users subscribers list] from the [https://mailman.ic.ac.uk/mailman/listinfo/gridpp-dirac-users list homepage] and see that you're on it. | * '''Joining the Imperial DIRAC mailing list''': once you have subscribed, you should be able to view the [https://mailman.ic.ac.uk/mailman/roster/gridpp-dirac-users subscribers list] from the [https://mailman.ic.ac.uk/mailman/listinfo/gridpp-dirac-users list homepage] and see that you're on it. | ||
| Line 21: | Line 29: | ||
==Your Virtual Organisation - testing== | ==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'''''. | * '''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. | + | * '''Accessing the Imperial DIRAC server as a VO member''': access https://dirac.gridpp.ac.uk 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 [mailto:lcg-site-admin@imperial.ac.uk lcg-site-admin@imperial.ac.uk]. |
| + | |||
| + | ==DIRAC client installation== | ||
| + | * I have [[Grid user crash course#Converting_your_grid_certificate|converted my grid certificate]] into a '''certificate file''' and '''key file''' and put these in my <code>~/.globus</code> 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 [[Quick_Guide_to_Dirac#Dirac_client_installation|here]]); | ||
| + | * I have generated a proxy with my grid certificate (following the instructions [[Quick_Guide_to_Dirac#Create_a_proxy_for_a_community|here]]). | ||
| + | |||
| + | ==DIRAC client installation - testing== | ||
| + | * '''Grid certificate conversion and installation''': when logged on to your local system, <code>ls ~/.globus</code> should return <code>usercert.pem</code> and <code>userkey.pem</code>; | ||
| + | * '''Contacting the configuration server''': when logged on to your local system, <code>nc -v 146.179.247.169 9135</code> 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 <code>. $DIRACDIR/bashrc</code>, you should be able to run (and tab-complete) the <code>dirac-*</code> commands; | ||
| + | * '''Proxy generation with DIRAC''': if the installation has been successful, upon entering the DIRAC proxy generation command: | ||
| + | <pre> | ||
| + | $ dirac-proxy-init -g northgrid_user -M | ||
| + | </pre> | ||
| + | you should asked to enter your certificate password and then receive a message similar to the following (the values in square brackets will vary): | ||
| + | <pre> | ||
| + | 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] | ||
| + | </pre> | ||
| + | |||
| + | ==The official DIRAC tutorials== | ||
| + | |||
| + | The "official" DIRAC tutorials can be found on their GitHub wiki [https://github.com/DIRACGrid/DIRAC/wiki/DIRAC-Tutorials 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 [mailto:lcg-site-admin@imperial.ac.uk 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 [https://github.com/DIRACGrid/DIRAC/wiki/JobManagement 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 <code>InputSandbox</code>. | ||
| + | |||
| + | ===Tutorial 5. Data management basics=== | ||
| + | After following the [https://github.com/DIRACGrid/DIRAC/wiki/DataManagement 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 <code>/$VO_NAME/user/$SUERNAME_FIRST_INITIAL/$USERNAME/</code>; | ||
| + | * Download the file from the SE to <code>$WORKINGDIR/tmp</code>; | ||
| + | * 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 [https://github.com/DIRACGrid/DIRAC/wiki/FileCatalog tutorial], I can: | ||
| + | * Start the DIRAC File Catalog interface; | ||
| + | * Move to my user directory in the DFC, <code>/$VO_NAME/user/$USERNAME_FIRST_INITIAL/$USERNAME/</code>; | ||
| + | * 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 <code>ls -ltr</code> on the worker node - should run successfully. You can retrieve the output using <code>dirac-wms-job-get-output [job ID]</code>, and view the <code>$WORKINGDIR/[job ID]/StdOut</code> file. | ||
| + | * '''Submitting a script with the InputSandbox''': your job runs the script uploaded with the <code>InputSandbox</code> runs successfully. You can retrieve the job output and view any files that you requested be retrieved with <code>OutputSandbox</code> in the <code>$WORKINGDIR/[job ID]</code> 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. | ||
| + | |||
| + | --> | ||
Latest revision as of 13:59, 22 September 2015
This page has moved to the GridPP GitHub site. Please follow the instructions there and leave feedback via the GitHub Issue system - thanks!
Return to the Quick Guide to DIRAC.
