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

If the DISABLE_BACKUP_MODE parameter is set to yes and the database is in the backup mode,
the Oracle database instance package start or failover on other node alters the database to remove
the backup mode before starting. Also, the START_MODE parameter should be set to open.
nl
If Oracle database recovery is needed, then package fails to start. The following message is logged
in the package log:
nl
Unable to get the database out of the backup mode. You must get the
database out of the backup mode before starting the package. The toolkit
does not perform any action during database recovery.
nl
If DISABLE_BACKUP_MODE is set to no, then this feature is not enabled.
Support for sourcing the user defined environment variables for Oracle Instance
It optionally provides a way to set the environment variables specific to Oracle instance during
package startup.
To set the environment variables specific to Oracle instance during package startup, follow the
steps:
1. The attribute PARENT_ENVIRONMENT in the package configuration file must be set to “yes”.
2. The required environment variables must be defined in the file customer.conf and placed
in the package directory (TKIT_DIR).
WARNING! HP recommends you not to override the Oracle toolkit attributes defined in the
package configuration through this file.
Cluster verification for ECMT - Oracle Toolkit
Cluster verification is a proactive mechanism to identify cluster inconsistencies that adversely affects
toolkit package failover to a node. It is a check for Serviceguard, Toolkit, and Oracle database
versions on all the package nodes of the cluster. Cluster verification is supported in Serviceguard
A.11.20.00 and ECMT B.06.00 Patch A or later. It does not fail the cmcheckconf command,
but logs appropriate warning messages are logged. In future, you can add new checks in an
incremental fashion, transparent to Serviceguard.
Example:
Consider a two-node cluster, both nodes having Serviceguard A.11.20 and ECMT B.06.00 but
different Oracle database versions. Use cmcheckconf command to check package configuration.
For example: node1# cmcheckconf -P pkg.conf
On node1, validation of the package Oracle_pkg, succeeded with:
The toolkit configuration file will be backed up and a new file will be created in tkit_dir when the package
configuration is applied.
On node2, validation of package Oracle_pkg succeeded with:
The toolkit configuration file in the configuration directory are backed up and a new file is created in tkit_dir
when the package configuration is applied.
WARNING: Oracle database version on all package nodes does not match.
Check syslog for more details.
cmcheckconf: Verification completed. No errors found.
Use the cmapplyconf command to apply the configuration.
Oracle package configuration example
Package Setup and Configuration
Consider that Oracle is already installed in its default home directory (for example, /home/oracle),
perform the following steps to make necessary directories shareable by all clustered nodes:
If you are using LVM or VxVM
For more information on creating a logical volume infrastructure on a shared disk, see section
Building an HA Cluster Configuration in the latest Managing Serviceguard manual available at
http://www.hp.com/go/hpux-serviceguard-docs—>HP Serviceguard . The disk must be available
to all clustered nodes that will be configured to run this database instance. Create a file system to
22 Using the Oracle Toolkit in an HP Serviceguard Cluster