Managing HP Serviceguard A.11.20.10 for Linux, December 2012

7.7 Configuring a Legacy Package
IMPORTANT: You can still create a new legacy package. If you are using a Serviceguard Toolkit
such as Serviceguard NFS Toolkit, consult the documentation for that product.
Otherwise, use this section to maintain and re-work existing legacy packages rather than to create
new ones. The method described in Chapter 6: “Configuring Packages and Their Services ”
(page 163), is simpler and more efficient for creating new packages, allowing packages to be built
from smaller modules, and eliminating the separate package control script and the need to distribute
it manually.
If you decide to convert a legacy package to a modular package, see “Migrating a Legacy Package
to a Modular Package” (page 232). Do not attempt to convert Serviceguard Toolkit packages.
Creating or modifying a legacy package requires the following broad steps:
1. Generate the package configuration file
2. Edit the package configuration file
3. Generate the package control script
4. Edit the package control script
5. Distribute the control script to the cluster nodes
6. Apply the package configuration file
Each of these tasks is described in the sub-sections that follow.
7.7.1 Creating the Legacy Package Configuration
The package configuration process defines 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 also includes a
prioritized list of cluster nodes on which the package can run together with definitions of the
acceptable types of failover allowed for the package.
7.7.1.1 Using Serviceguard Manager to Configure a Package
You can create a legacy package and its control script in Serviceguard Manager; use the Help
for detailed instructions.
7.7.1.2 Using Serviceguard Commands to Configure a Package
Use the following procedure to create a legacy package.
1. Create a subdirectory for each package you are configuring in the $SGCONF directory:
mkdir $SGCONF/pkg1
You can use any directory names you like. (See “Understanding the Location of Serviceguard
Files” (page 129) for the name of Serviceguard directories on your version of Linux.)
2. Generate a package configuration file for each package, for example:
cmmakepkg -p $SGCONF/pkg1/pkg1.conf
You can use any file name you like for the configuration file.
3. Edit each configuration file to specify package name, prioritized list of nodes (with 39 bytes
or less in the name), the location of the control script, and failover parameters for each
package. Include the data you recorded on the Package Configuration Worksheet.
7.7.1.2.1 Configuring a Package in Stages
It is a good idea to configure failover packages in stages, as follows:
1. Configure volume groups and mount points only.
2. Distribute the control script to all nodes.
7.7 Configuring a Legacy Package 225