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

Table 5 List of Attributes Supported for Online Toolkit Package Modification (continued)
DescriptionAttribute
You can list multiple recipients by repeating the email_id
field and address. Toolkit sends an alert email on listener
and package failure. If configured, the alert mail is sent
for Oracle database hang detection. For example:
$SGCONF/scripts/tkit/oracle/tkit_module.sh
oracle_hang_monitor 30 alert. By default,
email_id is commented.
Oracle Toolkit supports the online modification of service
attributes. By default, three monitoring services are started.
Monitoring service attributes
Services can be added, changed, or removed depending
on monitoring requirements.
To perform online package modification:
1. While package is up and running, retrieve the current package configuration values using
the command cmgetconf.
For example: #cmgetconf -p <<Toolkit_Package_Name>> <<Latest_Toolkit_Conf_File>>
2. Backup this latest configuration file using a copy utility. This allows you to refer to the previous
configuration values.
For example: # cp -p <<Latest_Toolkit_Conf_File>> <<Backup_Toolkig_Conf_File>>
3. Edit the <<Latest_Toolkit_Conf_File>> file to modify the required attribute values.
4. Use the cmcheckconf command to verify the package configuration file.
For example: #cmcheckconf –P <<Latest_Toolkit_Conf_File>>
5. Use the cmapplyconf command to add the new changes in the package configuration to
the Serviceguard cluster environment.
For example: #cmapplyconf –P <<Latest_Toolkit_Conf_File>>
NOTE: Information related to package reconfiguration is logged in the package log.
If you modify any other attributes, the following error message appears on the console.
ERROR: Online modification of attribute "<Attribute name>" is not allowed
For example: If an user tries to change the value of ORACLE_HOME while the package is running,
the cmapplyconf command fails with an error message.
ERROR: Online modification of attribute "ORACLE_HOME" is not allowed.
Halting a package
To halt a package, run the following command:
# cmhaltpkg <package_name>
Deleting a package
To delete a package from the cluster, run the following command:
# cmdeleteconf -p <package_name>
This command prompts for a confirmation, before removing the package configuration from the
cluster binary file, unless you use the -f option.
48 Using HP Serviceguard toolkit for Oracle