Managing Serviceguard Nineteenth Edition, Reprinted June 2011

Generating the Package Configuration File
When you have chosen the configuration modules your package needs (see “Choosing Package
Modules” (page 217)), you are ready to generate a package configuration file that contains those
modules. This file will consist of a base module (usually failover, multi-node or system multi-node)
plus the modules that contain the additional parameters you have decided to include.
Before You Start
Before you start building a package, create a subdirectory for it in the $SGCONF directory (/etc/
cmcluster); for example:
mkdir $SGCONF/pkg1
cmmakepkg Examples
The cmmakepkg command generates a package configuration file. Some examples follow; see
the cmmakepkg (1m) manpage for complete information. All the examples create an editable
configuration file pkg1.conf in the $SGCONF/pkg1 directory.
NOTE: If you do not include a base module (or default or all) on the cmmakepkg command
line, cmmakepkg will ignore the modules you specify and generate a default configuration file
containing all the parameters.
For a complex package, or if you are not yet sure which parameters you will need to set, the
default may be the best choice; see the first example below.
You can use the-v option with cmmakepkg to control how much information is displayed online
or included in the configuration file. Valid values are 0, 1 and 2. -v 0 removes all comments; -v
1 includes a brief heading for each parameter; -v 2 provides a full description of each parameter.
The default is level 2.
• To generate a configuration file that contains all the optional modules:
cmmakepkg $SGCONF/pkg1/pkg1.conf
• To create a generic failover package (that could be applied with out editing):
cmmakepkg -n pkg1 -m sg/failover $SGCONF/pkg1/pkg1.conf
• To generate a configuration file for a failover package that uses relocatable IP addresses and
runs an application that requires file systems to be mounted at run time (enter the command
all on one line):
cmmakepkg -m sg/failover -m sg/package_ip -m sg/service -m
sg/filesystem -m sg/volume_group $SGCONF/pkg1/pkg1.conf
• To generate a configuration file for a multi-node package that monitors cluster resources (enter
the command all on one line):
cmmakepkg -m sg/multi_node -m sg/resource $SGCONF/pkg1/pkg1.conf
• To generate a configuration file for a failover package that runs an application that requires
another package to be up (enter the command all on one line):
cmmakepkg -m sg/failover -m sg/dependency -m sg/service
$SGCONF/pkg1/pkg1.conf
• To generate a configuration file adding the services module to an existing package (enter
the command all on one line):
cmmakepkg -i $SGCONF/pkg1/pkg1.conf -m sg/service
$SGCONF/pkg1/pkg1_v2.conf
Generating the Package Configuration File 241