HP Serviceguard Enterprise Cluster Master Toolkit User Guide (5900-2145, April 2013)
Table Of Contents
- HP Serviceguard Enterprise Cluster Master Toolkit User Guide
- Contents
- 1 Introduction
- 2 Using the Oracle Toolkit in an HP Serviceguard Cluster
- Overview
- Supported Versions
- Support for Oracle Database Without ASM
- Supporting Oracle ASM Instance and Oracle Database with ASM
- What is Automatic Storage Management (ASM)?
- Why ASM over LVM?
- Configuring LVM Volume Groups for ASM Disk Groups
- Sample command sequence for configuring LVM Volume Groups
- Serviceguard support for ASM on HP-UX 11i v3 onwards
- Framework for ASM support with Serviceguard
- Installing, Configuring, and Troubleshooting
- Setting up DB instance and ASM instance
- Setting up the Toolkit
- ASM Package Configuration Example
- Modifying a Legacy Database Package Using an Older Version of Oracle ECMT Scripts to use the Scripts Provided for ASM Support
- Adding the Package to the Cluster
- Node-specific Configuration
- Error Handling
- Network Configuration
- Database Maintenance
- Configuring and packaging Oracle single-instance database to co-exist with SGeRAC packages
- Configuring Oracle single-instance database that uses ASM in a Coexistence Environment
- Attributes newly added to ECMT Oracle toolkit
- Configuring a modular failover package for an Oracle database using ASM in a coexistence environment
- Configuring a legacy failover package for an Oracle database using ASM in a Coexistence Environment
- ECMT Oracle Toolkit Maintenance Mode
- Supporting EBS database Tier
- Oracle ASM Support for EBS DB Tier
- 3 Using the Sybase ASE Toolkit in a Serviceguard Cluster on HP-UX
- Overview
- Sybase Information
- Setting up the Application
- Setting up the Toolkit
- Sybase Package Configuration Example
- Creating the Serviceguard package using Modular method
- Adding the Package to the Cluster
- Node-specific Configuration
- Error-Handling
- Network configuration
- Database Maintenance
- Cluster Verification for Sybase ASE Toolkit
- 4 Using the DB2 Database Toolkit in a Serviceguard Cluster in HP-UX
- 5 Using MySQL Toolkit in a HP Serviceguard Cluster
- MySQL Package Configuration Overview
- Setting Up the Database Server Application
- Setting up MySQL with the Toolkit
- Package Configuration File and Control Script
- Creating Serviceguard Package Using Modular Method
- Applying the Configuration and Running the Package
- Database Maintenance
- Guidelines to Start Using MySQL Toolkit
- 6 Using an Apache Toolkit in a HP Serviceguard Cluster
- 7 Using Tomcat Toolkit in a HP Serviceguard Cluster
- Tomcat Package Configuration Overview
- Multiple Tomcat Instances Configuration
- Configuring the Tomcat Server with Serviceguard
- Setting up the Package
- Creating Serviceguard Package Using Modular Method
- Setting up the Toolkit
- Error Handling
- Tomcat Server Maintenance
- Configuring Apache Web Server with Tomcat in a Single Package
- 8 Using SAMBA Toolkit in a Serviceguard Cluster
- 9 Using HP Serviceguard Toolkit for EnterpriseDB PPAS in an HP Serviceguard Cluster
- 10 Support and Other resources
- 11 Acronyms and Abbreviations
- Index

By default, Local OS Authentication is enabled for Oracle 10g and 11g with default value of
"LOCAL_OS_AUTHENTICATION_listener_name = ON". The absence of this parameter in
LISTENER.ORA file implies the feature is enabled. If this feature is disabled, it can be re-enabled
by commenting or removing "LOCAL_OS_AUTHENTICATION_listener_name = OFF" from
LISTENER.ORA or by setting it to "LOCAL_OS_AUTHENTICATION_listener_name = ON".
NOTE: Plain text listener passwords cannot contain any space between characters when used
with Oracle toolkit.
Database Maintenance
There might be situations, when the Oracle database must be shut down for maintenance purposes
like changing configuration, without migrating the instance to standby node.
NOTE: This feature is enabled only when the package attribute MAINTENANCE_FLAG is set to
"yes".
For this example, consider that the package name is ORACLE_TEST0, package directory is
/etc/cmcluster/pkg/ORACLE_TEST0 and the ORACLE_HOME is configured as /ORACLE_TEST0.
Follow the procedure for the Database Maintenance:
1. Disable the failover of the package through cmmodpkg command:
$ cmmodpkg -d ORACLE_TEST0
2. Pause the monitor script.
Create an empty file /etc/cmcluster/pkg/ORACLE_TEST0/oracle.debug:
$ touch /etc/cmcluster/pkg/ORACLE_TEST0/oracle.debug
Toolkit monitor scripts (both database instance and listener monitoring scripts) which
continuously monitor Oracle process daemons' processes and the listener process, stops
monitoring these daemon processes. The following messages appear in the Serviceguard
Package Control script log: "Oracle toolkit pausing monitoring and entering maintenance
mode" and "Oracle toolkit pausing Listener <Listener_Name> monitoring and entering
maintenance mode".
3. If required, stop the Oracle database instance:
$ cd /etc/cmcluster/pkg/ORACLE_TEST0/
$ $PWD/toolkit.sh stop
4. Perform maintenance actions (for example, changing the configuration parameters in the
parameter file of the Oracle instance. If this file is changed, please remember to distribute the
new file to all cluster nodes).
5. Re-start the Oracle database instance again if you manually stopped it before maintenance:
$ cd /etc/cmcluster/pkg/ORACLE_TEST0/
$ $PWD/toolkit.sh start
6. Allow monitoring scripts to continue normally:
$ rm -f /etc/cmcluster/pkg/ORACLE_TEST0/oracle.debug
The following messages "Starting Oracle toolkit monitoring again after maintenance" and
"Starting Oracle Listener monitoring again after maintenance" appear in the Serviceguard
Package Control script log.
7. Enable the package failover
$ cmmodpkg -e ORACLE_TEST0
56 Using the Oracle Toolkit in an HP Serviceguard Cluster