ARC client installation

< 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. 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:

For apt-based distributions (Ubuntu, Debian):

wget -q http://download.nordugrid.org/DEB-GPG-KEY-nordugrid.asc -O- | sudo apt-key add -

For yum-based distributions (Fedora, CentOS):

sudo rpm --import http://download.nordugrid.org/RPM-GPG-KEY-nordugrid

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):

[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

For CentOS 5 or RHEL 5:

[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

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

sudo yum groupinstall "ARC Client"

=== Installing from a apt-based repository <ref>Much of this section is adapted from the NDGF wiki </ref> ===

To add the repositories in Ubuntu or Debian add the following lines:

deb http://download.nordugrid.org/repos/ubuntu/ lucid main
deb-src http://download.nordugrid.org/repos/ubuntu/ lucid main

in the /etc/apt/sources.list file. Replace lucid with intrepid, dapper, gutsy, hardy, jaunty or karmic as appropriate. When these lines have been added the local apt-database have to be updated using the following command:

$ sudo apt-get update

First we install the Globus certificate utilities:

sudo apt-get install globus-gsi-cert-utils-progs
sudo apt-get install globus-proxy-utils 

Next, we install the CA certificate needed for SweGrid:

sudo apt-get install ca-policy-igtf-classic ca-policy-igtf-mics ca-policy-igtf-slcs

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-ca-utils

Finally we install the ARC client software itself:

sudo apt-get install nordugrid-arc-client

This command will also pull in any extra packages needed for the client software.

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 User's Guide for more information.

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:

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
 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