NORDUGRID NORDUGRID-MANUAL-6 7/12/2010 The NorduGrid/ARC User Guide Advanced Resource Connector (ARC) usage manual 2 Contents 1 Preface 11 2 Roadmap 13 3 Client Installation 15 3.1 Beginner Installation . 15 3.1.1 Download . 15 3.1.2 Unpack . 15 3.1.3 Configure . 16 3.2 System-wide installation . 16 3.2.1 Installation via repositories . 17 3.2.2 Globus Toolkit . 18 3.2.3 Download the client . 18 3.2.4 Build . 19 3.2.5 Install the client . 20 3.3 Client configuration files . 21 3.3.1 client.conf . 21 3.3.2 srms.conf . 23 3.3.3 Deprecated configuration files . 24 4 Grid Certificates 25 4.1 Quick start with certificates . 25 4.1.1 Certificates in local standalone client . 25 4.1.2 Certificates for system-wide client installation . 27 4.1.3 Obtain a personal certificate . 27 4.2 Grid Authentication And Certificate Authorities . 28 4.2.1 Grid Login, Proxies . 28 4.2.2 Certificate Authorities . 29 4.2.3 Globus Grid certificates . 29 4.2.4 Associating yourself with a proper CA . 30 4.2.5 Friendly CAs . 31 4.2.6 Certificate Request . 32 4.2.7 Working with certificates: examples . 33 3 4 CONTENTS 5 Getting Access to Grid Resources: Virtual Organisations 35 5.1 NorduGrid Virtual Organisation . 35 5.2 Other Virtual Organisations . 36 6 Grid Session 37 6.1 Logging Into The Grid . 37 6.1.1 Proxy Handling Tips . 38 6.2 First Grid test . 38 6.3 Logging Out . 39 7 Describing Grid Tasks 41 7.1 Task Description Language: xRSL . 41 7.1.1 URLs . 42 7.1.2 Task Description: Attributes . 45 executable . 46 arguments . 46 inputFiles . 46 executables . 47 cache.................................................. 47 outputFiles . 48 cpuTime . 49 wallTime . 50 gridTime . 50 benchmarks . 51 memory . 51 disk .................................................. 51 runTimeEnvironment . 52 middleware . 52 opsys.................................................. 53 stdin.................................................. 53 stdout . 53 stderr . 54 join................................................... 54 gmlog ................................................. 54 jobName . 54 ftpThreads . 55 acl................................................... 55 cluster . 55 queue ................................................. 56 startTime . 56 lifeTime . 57 notify . 57 CONTENTS 5 replicaCollection . 57 rerun.................................................. 58 architecture . 58 nodeAccess . 58 dryRun . 58 rsl substitution . 59 environment . 59 count.................................................. 60 jobreport . 60 credentialserver . 60 7.2 Examples . 60 7.2.1 Hello World . 61 7.2.2 An Own Executable . 62 7.2.3 Many Executables . 62 8 Job Management 65 8.1 First steps: the test suite . 65 8.1.1 ngtest . 65 8.2 Working with jobs . 66 8.2.1 ngsync . 66 8.2.2 ngsub . 67 8.2.3 ngstat . 71 8.2.4 ngcat . 72 8.2.5 ngget . 73 8.2.6 ngkill . 75 8.2.7 ngresub . 76 8.2.8 ngclean . ..