Migrating packages from legacy to modular style

3
Introduction
Modular packages provide a new interface for configuring Serviceguard packages. They modularize both package
configuration files and the control script, allowing easier integration and validation of user-defined functions and
parameters. This document describes how to migrate current (legacy) packages to the new modular package
configuration. For more information, see the latest edition of the Managing Serviceguard manual at
docs.hp.com > High Availability > Serviceguard (or Serviceguard for Linux).
Intended audience
This document is intended for Serviceguard cluster administrators. It assumes that the reader is familiar with both the
legacy package and the new modular package configuration, and with the basics of HP-UX or Linux shell scripting.
Related documents
Managing Serviceguard (14 version or later), chapters 3, 4, 6, and 7
Man page for cmmigratepkg
Man page for cmeasymigrate
Terms and definitions
Modular package
Single package configuration file, introduced in Serviceguard A.11.18. The package configuration
information is included in only the package configuration (ASCII) file, whereas in pre-11.18
packages, the configuration information is in both the package ASCII file and the package
control script
Legacy package
Package configuration pre-11.18
Attribute
A configurable parameter in the package configuration file
Module
A building block that includes a specific set of attributes for package configuration
Attribute Definition File
(ADF) module file
ADF that defines a module. The ADF modules are used to build a modular package’s ASCII
configuration file. They define the attributes which the package ASCII file includes
Package Environment
Variable (PEV)
A user-definable variable that can be passed to external scripts
External script
A user-created script invoked by Serviceguard at validation/start/stop of a package
Toolkits
The toolkits refers to the following products:
Enterprise Cluster Master Toolkit, Oracle Toolkit for SG/Linux, Serviceguard Extensions for SAP/R3,
and Serviceguard extension for Recovery Audit Contractor (RAC) Toolkits
Customer defined area of
control script
The area where a user can add code in the legacy package control script; defined by the comments
“#START CUSTOMER DEFINED FUNCTIONS” and “#END CUSTOMER DEFINED FUNCTIONS”