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

Table 3 Variable or Parameter Name in haoracle.conf file (continued)
package halt script from completing, therefore preventing the standby node from
starting the instance. The value of TIME_OUT must be less than the
HALT_SCRIPT_TIMEOUT value set in the package configuration file.
IfHALT_SCRIPT_TIMEOUT is not defined then, it is the sum of all the
SERVICE_HALT_TIMEOUT's defined in the package. This variable has no effect on the
package failover times.
This parameter is used to mention whether the Oracle user's shell should be invoked
as a new shell or as a subshell that inherits the variables set in the parent shell. This
PARENT_ENVIRONMENT
can be set to only yes or no. Set to 'yes' if the Oracle user's shell should be invoked
as a subshell. Set to no if the Oracle user's shell should be invoked as a new shell. If
set to 'no', the Oracle user's profile file is executed and the variables set in this profile
file are available to the new shell.
This parameter indicates whether 'shutdown abort' needs to be executed before the
startup of the Oracle or ASM instance. 'shutdown abort' ensures the cleanup of
CLEANUP_BEFORE_STARTUP
uncleared shared memory or semaphores. This parameter can be set to only yes or
no. Default value is 'no'.
This parameter is used to specify the database shutdown mode only when a shutdown
is initiated by the user and not due to a failure of service. This parameter can take
USER_SHUTDOWN_MODE
values "abort" or "immediate" only. If "abort" is specified, the database is shutdown
using the abort option. If "immediate" is specified, the database is shutdown using
the immediate option.
This parameter is used to specify the email address for sending alerts.ALERT_MAIL_ID
This parameter is used to set the time interval to wait in case of ORA errors during
database hang monitor. If there is any ORA error during hang monitor, the toolkit
RETRY_INTERVAL_ORA_ERROR
retries three times with a time interval of RETRY_INTERVAL_ORA_ERROR seconds. If
all the consecutive retry fails, then it is considered as failure. This avoids unnecessary
failover in case of temporary ORA errors. The implication is that it delays the detection
of db hang by 3 * RETRY_INTERVAL_ORA_ERROR seconds in case of actual ORA
errors.
nl
By default, RETRY_INTERVAL_ORA_ERROR is set to zero. When this parameter is set
to zero, there is no delay in database hang detection since toolkit will not retry.
This parameter is used to withdraw backup mode from the Oracle database. The valid
values for this parameter are yes or no. The default value is no. This means, if the
DISABLE_BACKUP_MODE
database is in backup mode, after failover or restart, the Oracle toolkit package fails
to start. You must manually bring the database out of the backup mode and then start
the package. When the value of DISABLE_BACKUP_MODE is set to yes and the
database is in backup mode, after failover or restart, the Oracle toolkit package alters
the database to remove the backup mode, and starts the database. This task is
performed only if START_MODE is set to open.
For modular packages, there is an Attribute Definition File (ADF) - oracle.1, a Toolkit Module Script
(tkit_module.sh), and a Toolkit Configuration File Generator Script (tkit_gen.sh) that work with
the six scripts mentioned in Table 3 for legacy packages, to integrate Oracle with the Serviceguard
Master Control Script.
NOTE: The following three scripts are used only during the modular method of packaging.
Table 4 Modular Package Scripts
DescriptionScript Name
For every parameter in the legacy toolkit user configuration file, there is an
attribute in the ADF. It also has an additional attribute TKIT_DIR which is
Attribute Definition File (oracle.1)
Support for Oracle Database Without ASM 17