HP Serviceguard Toolkit for Oracle on Linux User Guide (May 2013)

Running a package
To start a package, run the following command:
# cmrunpkg <package_name>
Maintaining a package
Serviceguard normally monitors critical processes, but there might be situations when a planned
maintenance task (for example, changing the configuration) affects those monitored processes.
The maintenance flag can be used to signal to the toolkit that it must not failover the instance to
an adoptive node in case of Oracle instance failure. However, Serviceguard still monitors other
resources used by the toolkit package. In case, any of the resources fails, Serviceguard fails over
the toolkit package to the adaptive node.
To set a package to the maintenance mode:
1. To enable the maintenance mode feature in the package configuration file, set the
MAINTENANCE_FLAG attribute to yes in package configuration file.
2. To start the maintenance mode for the package, create the oracle.debug file under the
package directory:
# touch oracle.debug
3. To stop the maintenance mode and bring the package out of maintenance mode, remove the
oracle.debug file from the package directory:
# rm oracle.debug
Online Modification of the Oracle Toolkit package
In addition to the Online modification feature supported by Serviceguard, the online modification
feature of toolkit allows you to modify some of the toolkit attribute values, while the toolkit package
is up and running. Table 5 (page 46) lists the attributes that are supported for online toolkit package
modification.
Table 5 List of Attributes Supported for Online Toolkit Package Modification
DescriptionAttribute
Oracle Toolkit supports online modification of this attribute.TKIT_DIR
Oracle Toolkit supports online modification of this attribute.
This attribute denotes the database startup. The attribute
value takes effect during the next startup of the database.
START_MODE
Oracle Toolkit supports online modification of this attribute.
This attribute can have either yes or no as its value. By
LISTENER
default, the value is set to yes. If you do not want to
monitor the listener in the toolkit package, LISTENER can
be set to no and comment out LISTENER_NAME and
oracle_listener_service attributes.
Oracle Toolkit supports online modification of this attribute.
The listener name can be changed, added, or removed
LISTENER_NAME
during online modification. The Listeners that are modified
or added must be configured and started manually before
adding to the toolkit package during online modification.
This ensures the listener is monitored when the package is
applied online. Similarly, if the Listener is removed from
the toolkit package, manual intervention is required to stop
the Listener.
Oracle Toolkit supports online modification of this attribute.
The Listener password can be modified and applied online
LISTENER_PASS
only if the values mentioned in LISTENER_PASS array
correspond with LISTENER_NAME array.
46 Using HP Serviceguard toolkit for Oracle