This information is for a release that is no longer supported by the Globus Toolkit. The currently supported versions of the Globus Toolkit are 4.2 (recommended) and 4.0.

Globus Toolkit 3.2: Installation Guide

Overview
Before You Begin
Support Software
Installing GT 3.2
Configuring > pre-Web Services <
Testing
Troubleshooting

Configuring pre-Web Services Components

This page is specifically for those who have downloaded only the Pre-WS Bundles.

The following instructions will show you how to start up the various server daemons that you now have on your system independent of the rest of Globus Toolkit 3.2.

In cases where we refer to LD_LIBRARY_PATH, please use your system-equivalent if you have one.  E.g., LIBPATH or LD_LIBRARYN32_PATH.  See your administrator if you do not know which variable to use.

This page contains the following topics.

Setting up a GridFTP Server

Since the procedure for configuring a GridFTP server is the same whether you are using Pre-WS or WS, follow the instructions for Configuring GridFTP.

Setting up a Pre-WS GRAM Server

Set up a Full Gatekeeper
Configure your machine to run globus-gatekeeper as root, so that other people will be able to use your gatekeeper. If you're also running pre-WS MDS, now is a good time to run $GLOBUS_LOCATION/setup/globus/setup-globus-gram-job-manager. That will let your MDS installation publish the subject name used by your gatekeeper.
1

As root, find /etc/services and add the service name "gsigatekeeper" to port 2119:

gsigatekeeper 2119/tcp # Globus Gatekeeper

Configure Inetd/Xinetd
Depending on whether your host is running inetd or xinetd, you will need to modify its configuration. If the directory /etc/xinetd.d/ exists, then your host is likely running xinetd. If the directory doesn't exist, your host is likely running inetd.
2

Follow the appropriate instructions below according to what your host is running.

Inetd
As root, find /etc/inetd.conf and add the following entry, all on one line:

gsigatekeeper stream tcp nowait root
/usr/bin/env env LD_LIBRARY_PATH=GLOBUS_LOCATION/lib
GLOBUS_LOCATION/sbin/globus-gatekeeper
-conf GLOBUS_LOCATION/etc/globus-gatekeeper.conf

Be sure to replace GLOBUS_LOCATION below with the actual value of $GLOBUS_LOCATION in your environment.

This line sets the environment variable by using /usr/bin/env (the location may vary on your system) to first set LD_LIBRARY_PATH, and then to call the gatekeeper itself.

The advantage of this setup is that when you apply a security update to your installation, the gatekeeper will pick it up dynamically without your having to rebuild it.

Xinetd
Go to the /etc/xinetd.d/ directory and add a file called globus-gatekeeper with the following contents.

service gsigatekeeper
{
socket_type = stream
protocol = tcp
wait = no
user = root
env = LD_LIBRARY_PATH=GLOBUS_LOCATION/lib
server = GLOBUS_LOCATION/sbin/globus-gatekeeper
server_args = -conf GLOBUS_LOCATION/etc/globus-gatekeeper.conf
disable = no
}

Be sure to replace GLOBUS_LOCATION with the actual value of $GLOBUS_LOCATION in your environment.

This file sets the environment by using the env = option to set LD_LIBRARY_PATH in the gatekeeper's environment.

The advantage of this setup is that when you apply a security update to your installation, the gatekeeper will pick it up dynamically without your having to rebuild it.

Notify Inetd/Xinetd of the configuration change
After you have added the globus-gatekeeper service to either inetd or xinetd, you will need to notify inetd (or xinetd) that its configuration file has changed.
3

Follow the appropriate instructions below according to what your host is running.

Inetd
On most Linux systems, you can simply run:

killall -HUP inetd

On other systems, the following has the same effect:

ps aux | grep inetd | awk '{print $2;}' | xargs kill -HUP

If neither option works, see man inetd.

Xinetd
On most Linux systems, you can simply run:

/etc/rc.d/init.d/xinetd restart

Your system may also support the reload option.

If neither option works, see man xinetd.

Authorization Mapping
At this point, your gatekeeper will start up when a connection comes in to port 2119, and will keep a log of its activity in $GLOBUS_LOCATION/var/globus-gatekeeper.log. However, it does not yet have any authorization mapping between certificate subjects and usernames.
4

Create a file named /etc/grid-security/grid-mapfile with single line entries listing a certificate subject and a username, such as the following example:

"/O=Grid/O=Globus/OU=your.domain/CN=Your Name" youruserid

You can check your subject name using grid-cert-info -subject. There are utility commands in $GLOBUS_LOCATION/sbin/grid-mapfile for adding entries, removing entries, and checking consistency.

Setting up a Pre-WS GIIS/GRIS

Starting the Pre-WS Index Service
Start the Pre-WS Index Service by starting the OpenLDAP 2.0 SLAPD server for the GRIS. It does not require the environment variable $GLOBUS_LOCATION to be set.
1

Run:

% GLOBUS_LOCATION/sbin/globus-mds start

To make this startup automatic, place it in the startup scripts of your machine. Contact your system administrator to determine where the call to this script needs to be placed. On a RedHat Linux system, the answer is /etc/rc.d/init.d, with a call to that script made in the appropriate /etc/rc.d/rc?.d (where ? is the default runlevel of your system, as specified in /etc/inittab).

There is a single SLAPD instance for both GRIS and GIIS.

You are now set for anonymous queries.

Configuring for Non-anonymous Queries
To configure for non-anonymous queries, you need a grid-mapfile for the Pre-WS Index Service (MDS2) and an LDAP server certificate.
2

The Pre-WS Index Service defaults to using the same grid-mapfile as GRAM, namely
/etc/grid-security/grid-mapfile

To change that location, modify $GLOBUS_LOCATION/etc/grid-info-server-env.conf.

3

Request an LDAP certificate by running:

% grid-cert-request -service ldap -host FQDN

Replace FQDN with the fully qualified domain name of the host that will run the LDAP server.

4

Send the request to your Certificate Authority.

This could be a SimpleCA you created, an existing CA, or the online certificate service.

5

When you retrieve your certificate, save it to /etc/grid-security/ldap/ldapcert.pem.

This file must be owned by the user account that will run the Pre-WS Index Service (MDS2). The file should have permissions 444.

Also change the ownership of /etc/grid-security/ldap/ldapkey.pem to the user account that will run the Pre-WS Index Service. Make sure ldapkey.pem has permissions 400.

6
Signing it with SimpleCA will be just like signing the other certificates.