Managing Serviceguard Seventeenth Edition, First Reprint December 2009

Generating the Package Configuration File
When you have chosen the configuration modules your package needs (see “Choosing
Package Modules” (page 256)), 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
Generating the Package Configuration File 287