#ident "@(#)$RCSfile: SMAWrac_9207_32_4.1A20-03.readme.txt,v $ - $Revision: 1.1 $ - $Date:" # # Copyright (c) 1990 Pyramid Technology # Copyright (c) 1996 Siemens Nixdorf / Siemens AG # Copyright (c) 2000-2007 Fujitsu Siemens Computers, Inc # 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.0.7 32-bit. Fixes in this version: On Oracle instance shutdown ORA-00600 occurs. This problem has the PULS number A0553202. It is also logged into the Oracle Bug Database as Bug No 5104131 Added changes required by Oracle RAC 9.2.0.7 Software Dependencies: The Fujitsu Siemens RAC package for Oracle 9.2.0.7 32-bit requires the following packages to be installed: * OS Solaris 8 01/01 or higher * SMAWcf 4.1A10 or higher * SMAWpas 4.1A10 or higher * SMAWsf 4.1A10 or higher The installation on PRIMECLUSTER V4.1A10 requires a patch for SMAWcf. This patch is available via Fujitsu, Fujitsu Siemens, Fujitsu Technology under the number: 901111-01 (Solaris 9) or 901110-01 (Solaris 8). If you use a lower version of CF you need to install the SMAWrac_9207_32_3.0 package This patch is already integrated in PRIMECLUSTER V4.1A20 or higher. Additional hints: - SMAWcf cluster framework is also required by SMAWpas, the PAS package does not declare a dependency to SMAWcf; this is covered by SMAWpas - SMAWpas parallel application services the RAC package declares a dependency to SMAWpas - SMAWsf shutdown facility this package is only required for node elimination, there are no binary interfaces between the SMAWrac and SMAWsf, therefore SMAWsf package does not declare a dependency to RMS Installation At this point you have already uncompressed and opened the tar file "SMAWrac_9207_32_4.1A20.tar.Z" In your current directory you have now the following files: * SMAWrac.ds (datastream containing the package SMAWrac) * readme (this document) The next steps are as follows: 1: Install SMAWrac package from the file SMAWrac.ds with 'pkgadd -d ./SMAWrac.ds SMAWrac' (you need to have superuser privileges for this) This step creates a directory "/opt/SMAW/SMAWrac/rac_9207_32_4.1A20" with several files. 2: Run the shell script "/opt/SMAW/SMAWrac/rac_9207_32_4.1A20/prepare_rac.sh" This step installs a library that will be used by runInstaller during Oracle installation. It reports the cluster configuration to runInstaller. 3: Install Oracle 9i Release 9.2.0.7 or higher runInstaller should detect the cluster and perform a cluster installation. 4: Install any required patches provided by Oracle (you need to obtain this patch via metalink.oracle.com) 5: Run the shell script "/opt/SMAW/SMAWrac/rac_9207_32_4.1A20/enable_rac.sh" This step places the PRIMECLUSTER communication library into Oracle's lib-directory. This script now supports the "-l" parameter. Using this parameter the PRIMECLUSTER communication library will only be replaced on the local node (It is recommended to run this step after every Oracle patch installation This is due to the fact that Oracle might install their version of the library as part of the patch). The package can be removed in two steps: R1: run /opt/SMAW/SMAWrac/rac_9207_32_4.1A20/remove_rac.sh with superuser privileges; this step restores Oracle's default/dummy communication library. This script now supports the "-l" parameter. Using this parameter Oracle's default/dummy communication library will only be replaced on the local node. R2: remove the package with pkgrm SMAWrac To update from a Oracle 9.2.0.3 installation to Oracle 9.2.0.7: Simply remove the old package as described in the respective Readme. Afterwards install this package and run the "enable_rac" step only. Restrictions This package is not compatible with Oracle 9i versions prior 9.2.0.7. Installation Hints Oracle's runInstaller in the current release (9.2.0.3) is checking for the existence of the directory "/opt/SUNWcluster" before it is using files from the directory "/opt/ORCLcluster". This bug should be fixed with a later release. As a workaround the script "prepare_rac.sh" is creating the directory "/opt/SUNWcluster. This directory is not used for any other purpose and should be empty. All three scripts (prepare_rac.sh, enable_rac.sh and remove_rac.sh) try to accomplish the corresponding function on each node in the cluster. The scripts do this with two utilities (cfsh, cfcp) which were released with PRIMECLUSTER V4.0. Should these two utilities not exist, the scripts try to revert to rsh and rcp respectively. Please note that the remote node address in a cfsh/cfcp command refers to the node's cluster name, whereas the remote node address in a rsh/rcp command refers to the node's network name. Usually both name spaces are identical (it makes little or no sense to have two different naming schemes). However, should these two naming schemes be different, manual intervention is required. 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. Manual intervention is required should a script not succeed on a remote node. The easiest manual workaround is to install SMAWrac on the other node directly and to run the script directly on the other node. Alternatively, the directory /opt/SMAW/SMAWrac/rac_9207_32_4.1A20 has to be copied to the remote node (using the same name) and the scripts have to be called directly on the remote node.