ARC client installation instructions
This is a short client installation description. For more detailed
instructions, please consult the relevant sections of the
NorduGrid User Manual.
Pre-requisite: You are logged into a Linux 2.x machine (RH6.2
and above, Mandrake 8.x and above, Debian 3.0, SuSE 8.1 and above,
FC1,2 have all been tested). NB! Your host name must be
set properly, i.e., it must resolve to a proper IP address.
Standalone client
~ System-wide client and Globus
~ Build on top of existing Globus
Option 1:
Installing the standalone client locally
(as non-root user)
Installation procedure:
- Get the pre-compiled standalone binary tarball from the NorduGrid Downloads
area: use the "Quick start" button and select your platform.
- Put the tarball in a directory of your choice and execute
tar xvzf nordugrid-standalone-<x.y.z>.tgz
This will create a new directory
nordugrid-standalone-<x.y.z> and the
tarball can hereafter safely be removed.
- enter the NorduGrid directory:
cd nordugrid-standalone-<x.y.z>
- Setup the environment by executing one of the following:
for bash or zsh:
source setup.sh
for csh or tcsh:
source setup.csh
for ksh or any other shell where the source command is not defined:
. ./setup.sh
Upon first execution, this will print a
lot of informational output. Make sure there are no "error" or
"failure" messages.
- Make sure you have a personal Globus certificate (typically
located at $HOME/.globus/usercert.pem) and a
private key ($HOME/.globus/userkey.pem). If
you do not have such, you must contact your local Certificate Autority
(CA). If you are a resident of a Nordic country (Denmark, Finland,
Norway, Iceland or Sweden), you can generate the key and request the
certificate using the following tool:
grid-cert-request -int -ca
- Fire up your certificate with
grid-proxy-init
- For a quick check of your installation, issue an
ngtest command: e.g.
ngtest -t 7
- Have fun on the Grid!
Option 2:
Installing the NorduGrid client from an RPM on a Linux 2.x box (with no prior
Globus installation)
Installation procedure:
You will need to install 5 packages:
- gpt
- globus
- nordugrid-client
- ca_NorduGrid or similar
- ca_NorduGrid-certrequest-config or similar
The installation order and other instructions are presented below.
- Install Globus (preferably the latest release) on your system by
getting and installing the following RPMs in this order:
- Grid Packaging Tools (GPT)
- Globus Toolkit 2
To do this, go to the NorduGrid Downloads
area and under "External software" choose "gpt" and "globus".
- Check that the variables GLOBUS_LOCATION,
GPT_LOCATION are set according to your Globus
installation: unless you forced installation in a specific location,
the default locations should be /opt/globus and
/opt/gpt respectively.
- get and install the NorduGrid
client binary RPM for your system
(nordugrid-client-<x.y.z-1>.i386.rpm). It is available via
the NorduGrid Downloads
area, "NorduGrid middleware" section, "releases" or "tags" –
"client" link.
- Get and install the necessary Certificate
Authority (CA) RPMs from the NorduGrid Downloads
area, "CA certificates" section.
- Login into your user account, or, if you are being logged in, type
source /etc/profile.d/nordugrid.sh
to setup the correct environment. If you are in
a C-shell, use *.csh counterpart of the script
above. If the source command is not defined in your shell, use
. /etc/profile.d/nordugrid.sh
- Make sure you have a personal Globus certificate (typically
located at $HOME/.globus/usercert.pem) and a
private key ($HOME/.globus/userkey.pem). If
you do not have such, you must contact your local Certificate Autority
(CA). If you are a resident of a Nordic country (Denmark, Finland,
Norway, Iceland or Sweden), download and install the configuration
package from the NorduGrid Downloads
area, "CA certificates" section, "certrequest-config". After doing
this, generate the key and request the certificate with
grid-cert-request -int -ca
- If you plan to use the Virtual Organisation Membership Service
(VOMS), follow the instructions on VOMS
installation and usage.
- Fire up your certificate with
grid-proxy-init or, if you installed VOMS
clients,
voms-proxy-init
- For a quick check, issue an ngtest
command: e.g.
ngtest -t 7
- Have fun on the Grid!
Option 3:
Installing the NorduGrid client as root on your
Linux 2.x box on top of an existing Globus installation
Build and installation procedure:
- Check that the variables GLOBUS_LOCATION,
GPT_LOCATION are set according to your Globus installation:
unless you forced installation in a specific location,
default locations should be /opt/globus and
/opt/gpt respectively.
- Get from the NorduGrid Downloads
area, "NorduGrid middleware" section, "releases" or "tags" – "source" the
NorduGrid source RPM nordugrid-<x.y.z-1>.src.rpm and rebuild it:
rpm --rebuild nordugrid-<x.y.z-1>.src.rpm
Note: this will rebuild the entire NorduGrid middleware -- not only
the client.
- Install the created binary RPMs (for a client, you only need the
nordugrid-client RPM)
- Alternatively, you can grab a tarball containing the Nordugrid
source-code nordugrid-<x.y.z>.tar.gz and follow the usual procedure:
tar xvzf nordugrid-<x.y.z>.tar.gz
cd nordugrid-<x.y.z>
./configure
make
make
install
- Make sure you have a personal Globus certificate (typically
located at $HOME/.globus/usercert.pem) and a
private key ($HOME/.globus/userkey.pem). If
you do not have such, you must contact your local Certificate Autority
(CA). If you are a resident of a Nordic country (Denmark, Finland,
Norway, Iceland or Sweden), download and install the configuration
package from the NorduGrid Downloads
area, "CA certificates" section, "certrequest-config". After doing
this, generate the key and request the certificate with
grid-cert-request -int -ca
- If you plan to use the Virtual Organisation Membership Service
(VOMS), follow the instructions on VOMS
installation and usage.
- Fire up your certificate with
grid-proxy-init or, if you installed VOMS
clients,
voms-proxy-init
- For a quick check, issue an ngtest
command: e.g.
ngtest -t 7
- Have fun on the Grid!