Using Serviceguard Extension for RAC, 8th Edition, March 2009
To create the package with Serviceguard Manager select the cluster. Go to the actions menu and
choose configure package. To modify a package, select the package. For an instance package,
create one package for each instance. On each node, supply the SID name for the package name.
To create a package on the command line, use the cmmakepkg command to get an editable
configuration file.
Set the AUTO_RUN parameter to YES,if you want the instance to start up as soon as the node
joins the cluster. In addition, you should set the NODE_FAILFAST_ENABLED parameter to NO.
If you are using CVM disk groups for the RAC database, be sure to include the name of each
disk group on a separate STORAGE_GROUP line in the configuration file.
If you are using CFS or CVM for RAC shared storage with multi-node packages, the package
containing the RAC instance should be configured with package dependency to depend on the
multi-node packages.
The following is a sample of the setup dependency conditions in application package configuration
file:
DEPENDENCY_NAME mp1
DEPENDENCY_CONDITION SG-CFS-MP-1=UP
DEPENDENCY_LOCATION SAME_NODE
DEPENDENCY_NAME mp2
DEPENDENCY_CONDITION SG-CFS-MP-2=UP
DEPENDENCY_LOCATION SAME_NODE
DEPENDENCY_NAME mp3
DEPENDENCY_CONDITION SG-CFS-MP-3=UP
DEPENDENCY_LOCATION SAME_NODE
Configuring Packages that Access the Oracle RAC Database
You can also use packages to start up applications that access the RAC instances. If an application
is intended to fail over among cluster nodes, then you must set it up as a distinct package, separate
from the package that starts and stops the RAC instance. Use the following procedures for
packages that contain applications which access the RAC database:
1. In the ASCII package configuration file, set the AUTO_RUNparameter to NO, or if you are
using Serviceguard Manager to configure packages, set Automatic Switching to
Disabled. This keeps the package from starting up immediately when the node joins the
cluster, and before RAC is running.
2. You can then manually start the package using the cmmodpkg -e packagename command
after RAC is started. Alternatively, you can choose to automate the process of package
activation by writing your own script, and copying it to all nodes that can run the package.
This script should contain the cmmodpkg -e command and activate the package after RAC
and the cluster manager have started.
Adding or Removing Packages on a Running Cluster
You can add or remove packages while the cluster is running, subject to the limit of
MAX_CONFIGURED_PACKAGES. For more detailed information on adding or removing packages
online, refer to section “Cluster and Package Maintenance” in the Managing Serviceguard Sixteenth
Edition user’s guide.
Writing the Package Control Script
The package control script contains all the information necessary to run all the services in the
package, monitor them during operation, react to a failure, and halt the package when necessary.
You can use either Serviceguard Manager or HP-UX commands to create or modify the package
control script. For security reasons, the control script must reside in a directory with the string
cmcluster in the path.
108 Serviceguard Configuration for Oracle 9i RAC