HP Serviceguard Developer's Toolbox Version B.12.00.00 For HP-UX and Linux

2 Installing Serviceguard developer's Toolbox
This section describes the procedure to install Serviceguard developer's Toolbox.
1. Untar and copy all the files into a directory.
NOTE: The Toolbox contains two files in a tar file.
Ensure that all the files are copied into the same directory.
2. Run setup.sh, and when prompted choose appropriate selection to install or uninstall.
The following files are installed on the successful completion of the setup:
• tkit_module.sh: The main Toolkit script that is called by the master control script of
Serviceguard. It is installed in the following location:
◦ HP-UX — /etc/cmcluster/scripts/ecmt/toolbox/tkit_module.sh
◦ RHEL — /usr/local/cmcluster/conf/scripts/tkit/toolbox/tkit_module.sh
◦ SLES — /opt/cmcluster/conf/scripts/tkit/toolbox/tkit_module.sh
• toolbox.1: Attribute Definition File that defines the Toolbox attributes included in the
package configuration file. It is installed in the following location.
◦ HP-UX — /etc/cmcluster/modules/ecmt/toolbox/toolbox.1
◦ RHEL — /usr/local/cmcluster/conf/modules/tkit/toolbox/toolbox.1
◦ SLES — /opt/cmcluster/conf/modules/tkit/toolbox/toolbox.1
A soft link named Toolbox pointing to the ADF file toolbox.1 is created in the
respective directories.
Application integration with HP Serviceguard
To manage an application with HP Serviceguard using the Toolbox, you must create an application
package, which is the basic entity being managed and moved within the HP Serviceguard cluster.
To initiate package creation, you must generate a package configuration file using the cmmakepkg
command.
NOTE: Serviceguard 11.18.05 or later in Linux, HP Serviceguard A.11.18 and additional
platform specific patches PHSS_38423 (on HP-UX 11iv2), PHSS_38424 (on HP-UX 11iv3) must
be installed before creating the package. Toolbox version B.12.00.00 supports only modular
packages.
To create a package:
HP-UX — #cmmakepkg –m ecmt/toolbox/toolbox pkg.conf
RHEL — #cmmakepkg –m tkit/toolbox/toolbox pkg.conf
SLES — #cmmakepkg –m tkit/toolbox/toolbox pkg.conf
While configuring a package configuration file, you must define a set of application services that
are run by the package manager when a package starts up on a node in the cluster.
The configuration includes cluster nodes on which the package can run, together with definitions
of the acceptable types of failover allowed for the package.
For more information, see the sample configuration files provided in Appendix A:“MySQL Toolkit
scripts” (page 15)
6 Installing Serviceguard developer's Toolbox