Using Serviceguard Extension for RAC, 6th Edition, April 2008
Creating Packages to Launch Oracle RAC Instances
To coordinate the startup and shutdown of RAC instances with cluster node startup
and shutdown, you create a one-node package for each node that runs an RAC instance.
In the package configuration file, you should specify only the single node on which
the instance will run and specify the control script that is to be executed every time the
instance node or the entire RAC cluster starts up or shuts down.
NOTE: You must create the RAC instance package with a PACKAGE_TYPE of
FAILOVER, but the fact that you are entering only one node ensures that the instance
will only run on that node.
To simplify the creation of RAC instance packages, you can use the Oracle template
provided with the separately purchasable ECM Toolkits product (T1909BA). Use the
special toolkit scripts that are provided, and follow the instructions that appear in the
README file. Also refer to the section “Customizing the Control Script for RAC
Instances” below for more information.
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 mp1DEPENDENCY_CONDITION SG-CFS-MP-1=UPDEPENDENCY_LOCATION SAME_NODE
DEPENDENCY_NAME mp2DEPENDENCY_CONDITION SG-CFS-MP-2=UPDEPENDENCY_LOCATION SAME_NODE
DEPENDENCY_NAME mp3DEPENDENCY_CONDITION SG-CFS-MP-3=UPDEPENDENCY_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:
Using Packages to Configure Startup and Shutdown of RAC Instances 131