Difference between revisions of "ARC client installation"

From SNIC Documentation
Jump to: navigation, search
m (Point to generic nordugrid repo page instead of old version.)
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Grid]]
+
[[Category:Grid computing]]
 +
[[Category:SweGrid user guide]]
 
[[Getting started with SweGrid|< Getting started with SweGrid]]
 
[[Getting started with SweGrid|< Getting started with SweGrid]]
 
== 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.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 a apt-based repository <ref>Much of this section is adapted from the [http://wiki.nordugrid.org/index.php/Ubuntu NDGF wiki]
 
</ref> ===
 
 
 
To add the repositories in Ubuntu or Debian add the following lines:
 
 
 
<pre>deb http://download.nordugrid.org/repos/ubuntu/ lucid main
 
deb-src http://download.nordugrid.org/repos/ubuntu/ lucid main</pre>
 
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:
 
 
 
<pre>$ sudo apt-get update</pre>
 
First we install the Globus certificate utilities:
 
 
 
<pre>sudo apt-get install globus-gsi-cert-utils-progs
 
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>
+
or
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:
 
  
<pre>sudo apt-get install nordugrid-arc-ca-utils</pre>
+
  sudo apt-get update
Finally we install the ARC client software itself:
+
  sudo apt-get install nordugrid-arc-client-tools
 
 
<pre>sudo apt-get install nordugrid-arc-client</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>[client]
+
[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
  
giis = 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. <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.
giis = ldap://index1.swegrid.se:2135/Mds-Vo-name=SweGrid,o=grid
 
  
debug = 1
+
More configuration options are available. Please check the [http://www.nordugrid.org/documents/arc-ui.pdf NorduGrid ARC Client User Guide] for more information.
timeout = 20</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.
+
== Verifying installation ==
  
More configuration options are available. Please check the [http://www.nordugrid.org/documents/userguide.pdf NorduGrid User's Guide] for more information.
+
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:
  
<references />
+
$ 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

Revision as of 08:01, 8 December 2015

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