NorduGrid 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,
Fedora Core 1 have all been tested). NB! Your host name must be
set properly, i.e., it must resolve to a proper IP address.
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!