Managing Serviceguard Sixteenth Edition, March 2009

• If your package will use relocatable IP addresses, define IP subnet and IP address
pairs. IPv4 or IPv6 addresses are allowed.
CAUTION: HP recommends that the subnet(s) be specified in the cluster
configuration file via the NETWORK_INTERFACE parameter and either the
HEARTBEAT_IP or STATIONARY_IP parameter; see “Cluster Configuration
Parameters ” (page 138).
If you do not follow this recommendation, the package may not behave as you
expect; see ip_subnet (page 272), ip_address (page 273), and “Stationary and
Relocatable IP Addresses ” (page 91) for complete information.
• Add service name(s).
• Add service command(s)
• Add a service restart parameter, if you so decide.
For more information about services, see the discussion of the service_ parameters
(page 273).
• Specify whether or not to kill processes accessing raw devices; see the comments
in the file under RAW DEVICES for more information.
Adding Customer Defined Functions to the Package Control Script
You can add additional shell commands to the package control script to be executed
whenever the package starts or stops. Enter these commands in the CUSTOMER DEFINED
FUNCTIONS area of the script.
If your package needs to run short-lived processes, such as commands to initialize or
halt a packaged application, you can also run these from the CUSTOMER DEFINED
FUNCTIONS.
You can also use the CUSTOMER DEFINED FUNCTIONS to determine why a package
has shut down; see “Determining Why a Package Has Shut Down” (page 187).
An example of this portion of the script follows, showing the date and echo commands
logging starts and halts of the package to a file.
# START OF CUSTOMER DEFINED FUNCTIONS
# This function is a place holder for customer defined functions.
# You should define all actions you want to happen here, before the service is
# started. You can create as many functions as you need.
function customer_defined_run_cmds
{
# ADD customer defined run commands.
: # do nothing instruction, because a function must contain some command.
date >> /tmp/pkg1.datelog
echo 'Starting pkg1' >> /tmp/pkg1.datelog
test_return 51
}
# This function is a place holder for customer defined functions.
344 Cluster and Package Maintenance