APBioGRID Globus Self-Installer

Version 0.1, 2001/12/25
Created by Guan Sin ONG <guansin@bic.nus.edu.sg>
for APBioGRID (www.apbionet.org/grid/)
Copyright (c) Asia Pacific BioInformatics Network (www.apbionet.org)


*** WHAT IS APBioGRID Globus Self-Installer? ***

This installer is created to help participants of APBioGRID install the 
Globus GRID software and set up the host into the APBioGRID. It aims to 
shield the participants from the nitty-gritty (and the pain) of installing
and configuring Globus. The installer package comes with all the components
necessary for Globus, namely OpenLDAP and SSLeay (or OpenSSL), and a custom-
ised install script. 

In summary, the installer condenses the whole process into three simple steps:

(1) untar the installer
(2) change directory into the installer directory
(3) launch installer script

as follows:

	tar xzf APBioGrid-Globus1.1.4-xxx-xxx.tar.gz
	cd APBioGrid-Globus1.1.4-xxx-xxx
	./install <globus-userid> <globus-home> <domain-name>

* Note: If your host is a.b.c, use "b.c" as the domain name.

These steps have to be done as root: su - root
<globus-userid> and <globus-home> must be created created already. 


*** SPACE REQUIREMENTS ***

The installer installs into a few locations and also uses /tmp for the install
process. The space requirements is as follows:

    /tmp  -  100MB (will be cleared after install)
    /opt  -  12MB 
    <globus-home>  -  110MB


*** WHAT THIS INSTALLER DOES ***

(This section is for the system administrator who wants to know the details
on what this installer does.)

1.  Make the Globus deploy directory /opt/globus. (This is currently not 
    configurable.

2.  Change ownership of /opt/globus to <globus-userid>

3.  Make a working directory for the installer at /tmp/APBioGrid-build.<pid>

4.  Copy the tarballs and installer specific files to the working directory.

5.  Change ownership of the working directory to <globus-userid>

6.  Switch user to <globus-userid> and execute install-user

* Executing as <globus-userid> with install-user script *

7.  Untar SSLeay/OpenSSL

8.  Make and install into <globus-home>/ssl

9.  Untar OpenLDAP

10. Make and install into <globus-home>/openldap

11. Untar Globus

12. Build Globus and install into <globus-home>

13. Replace the following files with those of the installer:

	<globus-home>/etc/grid-info.conf
	<globus-home>/etc/grid-security.conf
	<globus-home>/share/certificates/a20b22fc.0
	<globus-home>/share/certificates/ca-signing-policy.conf

14. Deploy Globus to /opt/globus using Globus's globus-local-deploy script.

* The following step is a fix for RH7x only; Globus fails to detect things 
* correctly

15. Replace various Linux OS related strings in 
    /opt/globus/etc/globus-jobmanager.conf

* End of execution of install-user script *

16. Remove working dir in /tmp

17. Append /opt/globus/etc/etc.services.modifications to /etc/services to
    define Globus Gatekeeper service

18. Append /opt/globus/etc/etc.inetd.conf.modifications to /etc/inetd.conf 
    <OR>
    copy local/xinetd.d/globus-gatekeeper to /etc/xinetd.d (for RedHat Linux)
    to add Globus Gatekeeper as a startable service by inetd/xinetd.

19. Restart inetd/xinetd to make change in 18 effective.

20. Change the following files to ownership of root for protection:
        /opt/globus/etc/globus-gatekeeper.cert 
        /opt/globus/etc/globus-gatekeeper.key 
        /opt/globus/sbin 
        /opt/globus/sbin/globus-gatekeeper-controller 
        /opt/globus/sbin/globus-gatekeeper 
        /opt/globus/libexec 
        /opt/globus/libexec/globus-k5 
        /opt/globus/etc 
        /opt/globus/etc/grid-mapfile 
        /opt/globus/etc/globus-services 
        /opt/globus/etc/globus-gatekeeper.conf

21. Copy /opt/globus/sbin/SXXglobus to /etc/rc3.d/S99globus, 
    /opt/globus/sbin/KXXglobus to /etc/rc0.d/K99globus (or more, depending
    on flavour of OS) to start up Globus upon bootup. 

22. Start up Globus for the first time by issuing 
        /opt/globus/sbin/SXXglobus start

23. Display the final steps which need to be carried out manually.