Client Installation Hands On
is the package provided by OSG for user interaction with the Grid: it allows to initiate the proxies and provides the clients to use Compute Elements and Storage Elements.
It can be installed as root for all the users in the system or by regular users for personal consumption.
Root installation of the client, both using Pacman and RPM packages, is covered in detail by the OSG release documentation:
This page presents a short version of the installation and covers mainly the personal installation.
OSG supports multiple Unix shells. The examples in this page use
or other shells see the referenced documentation.
Other hands-on guides are available at HandsOn
requires for you to have one of the many VDT supported platforms (see the VDT requirements
), network connection and about 1.2 GB of disk space available. To use the Grid you will need also your Grid Certificate
To install OSG client using RPM you need also a RHEL5 based OS (Centos 5 or SL5 are OK) and root access to the machine.
We assume that you are familiar with the basics of package management in a RHEL OSG, specially the use of
commands. If not please check the referenced documentation.
Add the package repositories
OSG software is distributed via the OSG yum repositories. Some packages depend on packages distributed via the EPEL
repositories. Both need to be enabled to install OSG RPMs.
- If not already present, install the package to use the EPEL repository:
rpm -i epel-release-5-4.noarch.rpm
- Install the OSG repositories:
rpm -Uvh http://vdt.cs.wisc.edu/repos/3.0/el5/testing/x86_64/osg-release-3.0-3.noarch.rpm
: enabling new repositories may add new packages or change the version of packages that you may get from other repositories
: if you have your own mirror or configuration of the EPEL repository, you MUST
verify that it contains the latest packages from EPEL and that the OSG repository has a better yum priority than EPEL. Otherwise, you will have strange deploying issues.
Install OSG client
1. Install the osg-client meta package, which will pull in all dependencies.
yum install --enablerepo=osg-testing --nogpgcheck osg-client
is a package management used by OSG.
OSG 1.2 requires Pacman 3.28 or later. If you have an earlier version or no Pacman, you need to install Pacman
tar --no-same-owner -xzvf pacman-3.28.tar.gz
It is recommended to install OSG-client in a local file system (on shared ones the installation may fail due to load). In the example I will use
, a local directory with write access to regular users
pacman -get http://software.grid.iu.edu/osg-1.2:client
when asked to trust the caches (you will trust al the caches used in the installation).
The installation should complete with something like:
Beginning VDT prerequisite checking script vdt-common/vdt-prereq-check...
All prerequisite checks are satisfied.
========== IMPORTANT ==========
Most of the software installed by the VDT *will not work* until you install
certificates. To complete your CA certificate installation, see the notes
in the post-install/README file.
The VDT version 2.0.0 has been installed.
The OSG Client package OSG version 1.2 has been installed.
ant gpt osg srm-client-lbnl berkeley-db jdk1.5 owamp trusted.caches
bwctl lcg pacman-platform-mapping vdt cert-scripts licenses pegasus vdt-app-data
condor logrotate perl vdt-install.log curl logs post-install voms
expat ndt pyglobus-url-copy wget fetch-crl npad setup.csh
glite o..pacman..o setup.sh globus openldap srm-client-fermi
Post install steps: downloading the CA certificates
vdt-ca-manage setupca --location local --url osg
More information about installing and using OSG-client is available in the ClientInstallationGuide
More information on available commands and how to use the OSG Client can be found in the ClientUseHandsOn
and the CE and Client validation section
both referenced below.
If you installed OSG client using Pacman, each time you want to use the client you must source the setup file (e.g.
A Pacman installation is a sandbox not affecting your default system environment.
If you installed OSG client using RPM, all the commands will be in your path ready to be used.
Here is a brief presentation placing the OSG client within the Grid stack and introducing the end user tutorial
that was presented during the March 09 OSG All Hands meeting.
In the ClientUseHandsOn
tutorial you will find useful information and examples of basic commands that you can run once you install the OSG client.