Building and Installing

WS RLS is distributed with the Globus Toolkit 4.2.0 and is available in both the binary bundles and the source bundle. For most purposes, the binary bundle provides the simplest means of installing the WS RLS and its requirements. There are three typical ways to access and install the WS RLS:

[Important]Important

Before proceding with installation of WS RLS, please familiarize yourself with the installation procedures for RLS (see Replica Location Service (RLS)).

1. Installing WS RLS using Globus Toolkit Binary Bundle

Follow instructions provided by Installing GT 4.2.0 and Installing GT in order to install the WS RLS from one of the available binary bundles of the Globus Toolkit.

Once you have unpackaged the binary bundle, the following commands may be used to install WS RLS:

% ./configure --prefix=$GLOBUS_LOCATION --enable-rls --enable-wsrls
% make
% make install
        

2. Installing WS RLS using Globus Toolkit Source Bundle

WS RLS is not installed as part of the default source install. In order to install WS RLS, you will need to ensure that RLS is also installed as part of the build by reviewing its installation procedures. Along with RLS configure settings (e.g., ODBC related settings) the --enable-wsrls flag is required as part of the configuration step.

The following commands will install the WS RLS (optionally you may use the "gt4-wsrls" make target to build only WS RLS and its requirements:

% ./configure --prefix=/path/to/install --enable-rls --enable-wsrls
% make [[rls] gt4-wsrls]
% make install
        

3. Installing WS RLS using Globus CVS

Additionally, you may access the WS RLS from the Globus Toolkit CVS repository. You may deploy the 4.1.x WS RLS on top of an existing GT 4.1.x installation using trunk.

[Important]Important

Please review Accessing the Globus Alliance's Code via CVS for the authoratative information on building and installing the Globus Toolkit from source in our CVS.

The following instructions may be used to build and install the WS RLS:

setenv CVSROOT :pserver:anonymous@cvs.globus.org:/home/globdev/CVS/globus-packages
cvs co packaging/
cd packaging
./make-packages.pl --bundles=gt4-wsrls --deps [--verbose]
setenv GPT_LOCATION /path/to/packaging/gpt-3.2globus2
$GPT_LOCATION/sbin/gpt-build [-verbose] ./bundle-output/custom-deps-1.0-src_bundle.tar.gz gcc32dbgpthr
        
[Note]Note

Changes to the toolkit (WS Core and WSAA) made between the 4.0.x release and the latest code base, make the GT 4.0.x build environment unsuitable for GT 4.2.0 components. As such the WS RLS cannot be deployed on an existing GT 4.0.x installation. The good news, if you will, is that the WS RLS can use your existing GT 4.0.x RLS without modification. If you have an existing RLS installation, and you want to try out the WS RLS interface layer, you need not reinstall RLS. Of course, you may want to reinstall RLS exclusively for testing with the WS RLS interface, but it is up to your own choosing.