Linux FailSafe 1.0
                        http://oss.sgi.com/projects/failsafe/
                        ====================================
			

This document describes how to configure and build the open source
Failsafe package from source, and how to install and run it.

0. If you have the binary RPMS, simply install them as per step 3 (below).

1. To build the FailSafe source RPMS there is a dependency on 'Rhino' headers
   and libraries. They can be accessed at http://oss.sgi.com/projects/rhino/download/.
   The packages to be installed are:

   sysadm_base-lib
   sysadm_base-client
   sysadm_base-dev
   

2. Building the RPMS

   FailSafe only uses make. To build the packages:

	# make rpms

   will create the RPM files:

	build/dist/RPMS/i386/cluster_admin-1.0.0-1.i386.rpm
	build/dist/RPMS/i386/cluster_services-1.0.0-1.i386.rpm
	build/dist/RPMS/i386/failsafe-1.0.0-1.i386.rpm
	build/dist/RPMS/i386/FailSafe-dev-1.0.0-1.i386.rpm
	build/dist/SRPMS/FailSafe-1.0.0-1.src.rpm

   Please refrain from using 'make install' as this doesn't set the correct file
   permissions as of now. 

3. Installing the RPMS

   FailSafe has a dependency on 'Rhino' libraries that can be accessed in the 
   'sysadm_base-lib' package at http://oss.sgi.com/projects/rhino/download/. Please 
   install this package before proceeding further.

   There is a useful tool called 'fsinstall' in the 'build' sub-directory. This 
   can be used to install the RPMS. It performs the following steps:

  A. Add entries to /etc/services
        sgi-cmsd        17001/udp        # Cluster membership services daemon
        sgi-crsd        17002/udp        # Cluster reset services daemon
        sgi-gcd         17003/udp        # SGI Group membership daemon
        sgi-cad         17004/tcp        # Cluster Admin daemon

  B. Install the RPMS
  
        cluster_admin-1.0.0-XXXX
        cluster_services-1.0.0-XXXX
        failsafe-1.0.0-XXXX

  C. Check rpm installation is correct

  D. Enable and disable appropriate failsafe and cluster applications during 
    boot-up time.

  E. Create links in run-level directories. This detects different distrbutions
     (SuSE and Redhat) and creates links for appropriate run-levels.

  F. Check for required RPMS like portmap and sysadm_base-lib.

  G. Based on user response (yes/no) it creates a new database and starts the
     cmond, cad, crsd & cdbd daemons.
 
  You could pack the RPMS and the 'fsinstall' tool and move it to different 
  machines in the cluster and repeat this step on all machines.


4. Installing the FailSafe GUI

   The FailSafe GUI is optional.  You can either build it from source, or
   install binary RPMS.  

   To build it from source, get the sysadm_failsafe SRPM, unpack it, and follow 
   the instructions in the INSTALL file in its top-level directory.  

   The binary RPMS come in two parts: server packages installed on one or more 
   of the nodes in your cluster, and client packages installed on any machine 
   from which you will administer the cluster.

   The server packages are:
       sysadm_base-tcpmux
       sysadm_base-lib
       sysadm_base-server
       sysadm_failsafe-server

   The client packages are:
       sysadm_base-client
       sysadm_failsafe-client

   See http://oss.sgi.com/projects/rhino/download/ for the sysadm_base-*
   packages, and http://oss.sgi.com/projects/failsafe/download/ for the
   sysadm_failsafe-* packages.

5. Aprroximate disk space required for installing binaries:

FailSafe = 20MB
FailSafe GUI (server side) = 6.2 MB
FailSafe GUI (server side) = 4.6 MB
Books (all formats) = 25 MB

6. How to Contribute

   See the CONTRIBUTE file in this directory for details about how to
   contribute to the Linux FailSafe project.