Difference between revisions of "ARC client installation"

From SNIC Documentation
Jump to: navigation, search
(Installing from an apt-based repository)
Line 4: Line 4:
 
== Installing from package repositories ==
 
== Installing from package repositories ==
  
The easiest way of installing the ARC middleware is by using the available apt- and yum-repositories. Before using these repositories the NorduGrid GPG-key must be installed to verify the installed packages. The GPG-key is installed using the following procedures:
+
The easiest way of installing the ARC middleware is by using the available apt- and yum-repositories. Read this information for setting up the repositories:
  
For apt-based distributions (Ubuntu, Debian):
+
http://download.nordugrid.org/repos-12.05.html
  
<pre>wget -q http://download.nordugrid.org/DEB-GPG-KEY-nordugrid.asc -O- | sudo apt-key add -</pre>
 
For yum-based distributions (Fedora, CentOS):
 
 
<pre>sudo rpm --import http://download.nordugrid.org/RPM-GPG-KEY-nordugrid</pre>
 
=== Installing from a yum-based repository ===
 
 
A yum repository is added by creating a file ''nordugrid.repo'' in the ''/etc/yum.repos.d'' directory. The file should contain the following (Fedora):
 
 
<pre>[nordugrid]
 
name=NorduGrid - $basearch - stable
 
baseurl=http://download.nordugrid.org/repos/fedora/$releasever/$basearch/stable
 
enabled=1
 
gpgcheck=1
 
gpgkey=http://download.nordugrid.org/RPM-GPG-KEY-nordugrid
 
 
[nordugrid-testing]
 
name=NorduGrid - $basearch - testing
 
baseurl=http://download.nordugrid.org/repos/fedora/$releasever/$basearch/testing
 
# Always make sure nordugrid stable repo is enabled
 
enabled=0
 
gpgcheck=1
 
gpgkey=http://download.nordugrid.org/RPM-GPG-KEY-nordugrid</pre>
 
For CentOS 5 or RHEL 5:
 
 
<pre>[nordugrid]
 
name=NorduGrid - $basearch - stable
 
baseurl=http://download.nordugrid.org/repos/redhat/el5/$basearch/stable
 
enabled=1
 
gpgcheck=1
 
gpgkey=http://download.nordugrid.org/RPM-GPG-KEY-nordugrid
 
 
[nordugrid-testing]
 
name=NorduGrid - $basearch - testing
 
baseurl=http://download.nordugrid.org/repos/redhat/el5/$basearch/testing
 
# Always make sure nordugrid stable repo is enabled
 
enabled=0
 
gpgcheck=1
 
gpgkey=http://download.nordugrid.org/RPM-GPG-KEY-nordugrid</pre>
 
 
Installing the ARC middleware can now be done using the following commands:
 
Installing the ARC middleware can now be done using the following commands:
  
<pre>sudo yum groupinstall &quot;ARC Client&quot;</pre>
+
  sudo yum install nordugrid-arc-client-tools
=== Installing from an apt-based repository ===
 
Much of this section is adapted from the [http://wiki.nordugrid.org/index.php/Ubuntu NDGF wiki].
 
 
 
This [http://download.nordugrid.org/repos-12.05.html page], describes how to configure the repository depending on your installed Debian/Ubuntu release.
 
 
 
When your apt-get config is set, issue the following command to update you packages repository:
 
 
 
<pre>$ sudo apt-get update</pre>
 
 
 
When this is done we start installing the required software. First we install the Globus certificate utilities:
 
  
<pre>sudo apt-get install globus-gsi-cert-utils-progs
+
or
sudo apt-get install globus-proxy-utils </pre>
 
Next, we install the CA certificate needed for SweGrid:
 
  
<pre>sudo apt-get install ca-policy-igtf-classic ca-policy-igtf-mics ca-policy-igtf-slcs</pre>
+
  sudo apt-get update
To make sure that we don't trust revoced certificates we also install the nordugrid-ca-utils package which is used to maintain the certificate revocation lists:
+
  sudo apt-get install nordugrid-arc-client-tools
 
 
<pre>sudo apt-get install nordugrid-arc-ca-utils</pre>
 
Finally we install the ARC client software itself:
 
 
 
<pre>sudo apt-get install nordugrid-arc-client-tools</pre>
 
This command will also pull in any extra packages needed for the client software.
 
  
 
== Client configuration ==
 
== Client configuration ==
Line 77: Line 21:
 
The configuration file for ARC is located in ''$HOME/.arc/client.conf''. A typical configuration file for SweGrid is shown below:
 
The configuration file for ARC is located in ''$HOME/.arc/client.conf''. A typical configuration file for SweGrid is shown below:
  
<pre>[common]
+
[common]
defaultservices=index:ARC0:ldap://index1.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid
+
defaultservices=index:ARC0:ldap://index1.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid index:ARC0:ldap://index2.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid
  index:ARC0:ldap://index2.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid
+
 
</pre>
 
 
The ''giis'' attribute sets the information system URL:s used for job brokering and information. The ''debug'' attribute sets the amount of debug messages shown when using the ARC command line tools. <tt>debug=0</tt> turns debug messages off. ''timeout'' is the timeout value in seconds for how long the commandline tools should wait for a response from a resource before giving up.
 
The ''giis'' attribute sets the information system URL:s used for job brokering and information. The ''debug'' attribute sets the amount of debug messages shown when using the ARC command line tools. <tt>debug=0</tt> turns debug messages off. ''timeout'' is the timeout value in seconds for how long the commandline tools should wait for a response from a resource before giving up.
  
More configuration options are available. Please check the [http://www.nordugrid.org/documents/userguide.pdf NorduGrid User's Guide] for more information.
+
More configuration options are available. Please check the [http://www.nordugrid.org/documents/arc-ui.pdf NorduGrid ARC Client User Guide] for more information.
  
 
== Verifying installation ==
 
== Verifying installation ==
  
The installation can be veified using the '''arcinfo''' command. If everything is configured correctly and you have been added to the SweGrid VO the '''arcinfo''' command you display the following output:
+
The installation can be verified using the '''arcinfo''' command. If everything is configured correctly and you have been added to the SweGrid VO the '''arcinfo''' command you display the following output:
 
 
<pre>user@centos6 ~]$ arcinfo
 
Execution Service: siri.lunarc.lu.se
 
URL: ARC0:ldap://siri.lunarc.lu.se:2135/nordugrid-cluster-name=siri.lunarc.lu.se,Mds-Vo-name=local,o=Grid
 
Queue: arc
 
Health state: ok
 
 
 
Execution Service: arc-ce01.pdc.kth.se
 
URL: ARC0:ldap://arc-ce01.pdc.kth.se:2135/nordugrid-cluster-name=arc-ce01.pdc.kth.se,Mds-Vo-name=local,o=Grid
 
Queue: swegrid
 
Health state: ok
 
 
 
Execution Service: grad.uppmax.uu.se
 
URL: ARC0:ldap://grad.uppmax.uu.se:2135/nordugrid-cluster-name=grad.uppmax.uu.se,Mds-Vo-name=local,o=Grid
 
Queue: grad
 
Health state: ok
 
 
 
Execution Service: arc-ce.smokerings.nsc.liu.se
 
URL: ARC0:ldap://arc-ce.smokerings.nsc.liu.se:2135/nordugrid-cluster-name=arc-ce.smokerings.nsc.liu.se,Mds-Vo-name=local,o=Grid
 
Queue: arc
 
Health state: ok
 
 
 
Execution Service: svea.c3se.chalmers.se
 
URL: ARC0:ldap://svea.c3se.chalmers.se:2135/nordugrid-cluster-name=svea.c3se.chalmers.se,Mds-Vo-name=local,o=Grid
 
Queue: svea
 
Health state: ok
 
  
Execution Service: jeannedarc.hpc2n.umu.se
+
$ arcinfo
URL: ARC0:ldap://jeannedarc.hpc2n.umu.se:2135/nordugrid-cluster-name=jeannedarc.hpc2n.umu.se,Mds-Vo-name=local,o=Grid
+
Execution Service: siri.lunarc.lu.se
Queue: batch
+
  URL: ARC0:ldap://siri.lunarc.lu.se:2135/nordugrid-cluster-name=siri.lunarc.lu.se,Mds-Vo-name=local,o=Grid
Health state: ok
+
  Queue: arc
</pre>
+
  Health state: ok
 +
 +
Execution Service: arc-ce01.pdc.kth.se
 +
  URL: ARC0:ldap://arc-ce01.pdc.kth.se:2135/nordugrid-cluster-name=arc-ce01.pdc.kth.se,Mds-Vo-name=local,o=Grid
 +
  Queue: swegrid
 +
  Health state: ok
 +
 +
Execution Service: grad.uppmax.uu.se
 +
  URL: ARC0:ldap://grad.uppmax.uu.se:2135/nordugrid-cluster-name=grad.uppmax.uu.se,Mds-Vo-name=local,o=Grid
 +
  Queue: grad
 +
  Health state: ok
 +
 +
Execution Service: arc-ce.smokerings.nsc.liu.se
 +
  URL: ARC0:ldap://arc-ce.smokerings.nsc.liu.se:2135/nordugrid-cluster-name=arc-ce.smokerings.nsc.liu.se,Mds-Vo-name=local,o=Grid
 +
  Queue: arc
 +
  Health state: ok
 +
 +
Execution Service: svea.c3se.chalmers.se
 +
  URL: ARC0:ldap://svea.c3se.chalmers.se:2135/nordugrid-cluster-name=svea.c3se.chalmers.se,Mds-Vo-name=local,o=Grid
 +
  Queue: svea
 +
  Health state: ok
 +
 +
Execution Service: jeannedarc.hpc2n.umu.se
 +
  URL: ARC0:ldap://jeannedarc.hpc2n.umu.se:2135/nordugrid-cluster-name=jeannedarc.hpc2n.umu.se,Mds-Vo-name=local,o=Grid
 +
  Queue: batch
 +
  Health state: ok

Revision as of 11:19, 8 June 2012

< Getting started with SweGrid

Installing from package repositories

The easiest way of installing the ARC middleware is by using the available apt- and yum-repositories. Read this information for setting up the repositories:

http://download.nordugrid.org/repos-12.05.html

Installing the ARC middleware can now be done using the following commands:

 sudo yum install nordugrid-arc-client-tools

or

 sudo apt-get update
 sudo apt-get install nordugrid-arc-client-tools

Client configuration

The configuration file for ARC is located in $HOME/.arc/client.conf. A typical configuration file for SweGrid is shown below:

[common]
defaultservices=index:ARC0:ldap://index1.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid index:ARC0:ldap://index2.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid

The giis attribute sets the information system URL:s used for job brokering and information. The debug attribute sets the amount of debug messages shown when using the ARC command line tools. debug=0 turns debug messages off. timeout is the timeout value in seconds for how long the commandline tools should wait for a response from a resource before giving up.

More configuration options are available. Please check the NorduGrid ARC Client User Guide for more information.

Verifying installation

The installation can be verified using the arcinfo command. If everything is configured correctly and you have been added to the SweGrid VO the arcinfo command you display the following output:

$ arcinfo
Execution Service: siri.lunarc.lu.se
 URL: ARC0:ldap://siri.lunarc.lu.se:2135/nordugrid-cluster-name=siri.lunarc.lu.se,Mds-Vo-name=local,o=Grid
 Queue: arc
 Health state: ok

Execution Service: arc-ce01.pdc.kth.se
 URL: ARC0:ldap://arc-ce01.pdc.kth.se:2135/nordugrid-cluster-name=arc-ce01.pdc.kth.se,Mds-Vo-name=local,o=Grid
 Queue: swegrid
 Health state: ok

Execution Service: grad.uppmax.uu.se
 URL: ARC0:ldap://grad.uppmax.uu.se:2135/nordugrid-cluster-name=grad.uppmax.uu.se,Mds-Vo-name=local,o=Grid
 Queue: grad
 Health state: ok

Execution Service: arc-ce.smokerings.nsc.liu.se
 URL: ARC0:ldap://arc-ce.smokerings.nsc.liu.se:2135/nordugrid-cluster-name=arc-ce.smokerings.nsc.liu.se,Mds-Vo-name=local,o=Grid
 Queue: arc
 Health state: ok

Execution Service: svea.c3se.chalmers.se
 URL: ARC0:ldap://svea.c3se.chalmers.se:2135/nordugrid-cluster-name=svea.c3se.chalmers.se,Mds-Vo-name=local,o=Grid
 Queue: svea
 Health state: ok

Execution Service: jeannedarc.hpc2n.umu.se
 URL: ARC0:ldap://jeannedarc.hpc2n.umu.se:2135/nordugrid-cluster-name=jeannedarc.hpc2n.umu.se,Mds-Vo-name=local,o=Grid
 Queue: batch
 Health state: ok