Generating the Package Configuration File

When you have chosen the configuration modules your package needs (see “Choosing Package Modules”), 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 (/etc/cmcluster) directory, 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

Next Step

The next step is to edit the configuration file you have generated; see “Editing the Configuration File”.

Generating the Package Configuration File

Technical documentation

» Table of Contents

» Index

Before You Start

cmmakepkg Examples

Next Step