Introduction
This guide contains advanced configuration information for system administrators working with the Replication Client. It provides references to information on procedures typically performed by system administrators, including installing, configuring, deploying, and testing the installation.
![[Important]](/docbook-images/important.gif) | Important |
|---|---|
This information is in addition to the basic Globus Toolkit prerequisite, overview, installation, security configuration instructions in the Installing GT 4.2.1. Read through this guide before continuing! |
Table of Contents
Replication Client is distributed with the Globus Toolkit 4.2.1 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 Replication Client and its dependencies. The GT make target for this component is gt4-replication-client and for tests gt4-replication-client-test. The make target is incuded in all. Basic installation steps:
% ./configure --prefix=$GLOBUS_LOCATION
% make [all | gt4-replication-client]
% make install
There are no additional steps for deploying. The Replication Client is a client-side tool. In order to use the client a Globus Replica Location Service (RLS) and a Globus GridFTP Server (GridFTP Server) must be accessible.
You must start a GridFTP Server on port 9001 of the local host. Note that GridFTP Server normally runs as the root user. See GridFTP for more details. If GridFTP Server is running on the local host on port 9001, run the following script.
% $GLOBUS_LOCATION/test/globus_replica_replication_test_unit/TESTS.pl
The above test performs unit testing of the replication client java API. If the command indicates errors or failures, check the web page in the directory as specified by the script for more details.
Next, run the following script to unit test the globus-replication-client command-line client.
% $GLOBUS_LOCATION/test/globus_replica_replication_test_client/TESTS.pl > test-output.html
To view the results of the client tests, open the html output file.
The Replication Client command-line uses the default security credential of the user. It uses this credential for calls to the RLS server and the GridFTP Server. Command-line options are available to set the user subject name for both source and destination. There is also an option to enable data channel authentication. See GridFTP Server documentation for more information on these options.
Table of Contents
For a list of common errors in GT, see Error Codes.