# %Z%%M%	Revision: %I%	%E% %U%
#
#      Copyright (c) 1990 Pyramid Technology
#      Copyright (c) 1996 Siemens Nixdorf / Siemens AG
#      Copyright (c) 2000, 2001, 2002 Fujitsu Siemens Computers
#      All Rights Reserved
#
#      THIS IS UNPUBLISHED PROPRIETARY SOURCE CODE OF
#      Fujitsu Siemens Computers.
#      The copyright notice above does not evidence any
#      actual or intended publication of such source code.
#


                  README file for customers


This readme file explains the steps involved in installing/checking/removing
the Fujitsu Siemens 9iRAC package for Oracle 9.2 32-bit.


Software Dependencies:

The Fujitsu Siemens RAC package for Oracle 9.2.0.2 32-bit 
requires the following packages to be installed:

 * OS RedHat Advanced Server V2.1 or higher
 * SMAWcf   4.0A10  or higher
 * SMAWpas  4.0A10  or higher
 * RMS      4.0A10  or higher


Additional hints:

 - SMAWcf cluster framework
          is also required by SMAWpas, SMAWrac does not declare
          a dependency to SMAWcf; this is covered by SMAWpas

 - SMAWpas parallel application services
           SMAWrac declares a dependency to SMAWpas

 - SMAWsf shutdown facility
          this package is only required for node elimination,
          there are no binary interfaces between SMAWrac and SMAWsf,
          therefor SMAWrac does not declare a dependency to SMAWsf


Installation

The installation of Oracle 9i RAC on Linux using PRIMECLUSTER
requires the following procedure:

 1:  Install Oracle 9i on each node of the cluster
     with the "Software Only" option.

 2:  Run the following commands on each node of the cluster:
     make  -f $ORACLEHOME/lib/ins_rdbms.mk  rac_on
     make  -f $ORACLEHOME/lib/ins_rdbms.mk  ioracle

 3:  Set the environment variable ORACLE_HOME to Oracle's
     home directory, e.g.: "export  ORACLE_HOME=/ora9i".
     This variable is required during the installation
     of SMAWrac in the next step.

 4:  Install SMAWrac on each node of the cluster with
     rpm -ivh SMAWrac_9201_32-1.i386.rpm

     The following steps take place during the installation
     of SMAWrac:

     a) two libraries are copied to the directory /opt/SMAW/SMAWrac/rac_9201_32:
          - libskgxn9.so  (node management functions)
          - libskgxp9.so  (internode communication functions)

     b) the README file is copied to the directory /opt/SMAW/SMAWrac/rac_9201_32

     c) the following standard Oracle libraries are saved:
          - $ORACLE_HOME/lib/libskgxn9.so to libskgxn9.so.bak-rac_9201_32
          - $ORACLE_HOME/lib/libcmdll.so to libcmdll.so.bak-rac_9201_32
          - $ORACLE_HOME/lib/libskgxp9.so to libskgxp9.so.bak-rac_9201_32
          - $ORACLE_HOME/lib/libskgxu9.so to libskgxu9.so.bak-rac_9201_32

    d) the new libraries are copied to $ORACLE_HOME/lib:
          - libskgxn9.so  to  libskgxn9.so
          - libskgxn9.so  to  libcmdll.so
          - libskgxp9.so  to  libskgxp9.so
          - libskgxp9.so  to  libskgxpu.so

    These replacements enable Oracle 9i RAC to use PRIMECLUSTER's 
    scalable, HA communication and PRIMECLUSTER's node management.



Removal

The removal of SMAWrac is done by "rpm -e SMAWrac".  A script
is run during the removal to restore the libraries which had
been replaced with the original libraries.  To do this, it is
necessary to set the environment variable "ORACLE_HOME" to
Oracle's home directory.  I.e., removal is a two step process:
  
  1:  Set ORACLE_HOME to Oracle's home directory, e.g.:
      export  ORACLE_HOME=/oracle

  2:  Run "rpm -e SMAWrac" to restore Oracle's original
      libraries and to remove the package.



Restrictions

1 Cluster Awareness of "runInstaller"

1.1 Reason

The Oracle installation methode as required above does not detect
the presence of a cluster.  
As a result, "runInstaller" triggers only the "stand alone" installation
when used in a PRIMECLUSTER environment and cluster-aware monitor
products (srvctrl, OEM, dbca, netca) are not available
in a PRIMECLUSTER environment.  
Messages like "libsrvm.so: cannot open shared object..."
are symptoms of cluster components which are not installed.
  
1.2 Work Around

Statistical data have to be extracted by statspack, utlbstat/utlestat;
in addition PrimeCluster provides some useful monitoring features.

1.3 Resolution

This restriction will be resolved with the next release of SMAWrac.
This release will place infrastructure information for Oracle's
runInstaller that will trigger its cluster mode installation.



Installation Hints


Installation of SMAWrac is only required on nodes that will be used
by an instance of Oracle 9i RAC; nodes that will not be used for this
do not require the installation of SMAWrac or its components.