Modular package support in Serviceguard for Linux Toolkits, August 2008

Introduction
This whitepaper describes support for modular packages in toolkits used in Serviceguard for Linux
(SGLX) environments. This support is enabled only on Serviceguard for Linux (SGLX) release
11.18.04 and later. This document is intended for users who want to install and configure
supported Linux applications (Oracle, NFS, MySQL, PostgreSQL, Sendmail, Samba, Apache, or
Tomcat) using modular packages. It assumes that readers are already familiar with Serviceguard
for Linux configuration, installation and configuration of legacy toolkits, supported applications
and their installation/configuration procedures.
Overview of modular packages
A new package layer has been introduced with the modular method of packaging applications.
The modular package layer is comprised of toolkit specific module ADFs (Attribute Definition File),
module scripts and the toolkit generator script.
A modular package consists of a set of shell scripts which is used by the Master Control Script to
start, stop and monitor the application.
This document assumes the following:
SGLX Release 11.18 and a platform specific patch from SGLX_00231 to SGLX_00239
has been installed on all servers to be configured as nodes of the cluster
The toolkit is installed on all target nodes
As delivered, this toolkit contains the following files in addition to the existing scripts of legacy
toolkits:
File Name Description
-------------------------------------------------------------------------------------------------------------------------------------------------------------
<app> Toolkit Module Attribute Definition File (ADF)
tkit_module.sh Module script for <app> application
tkit_gen.sh Toolkit Configuration File Generator Script
Note:
In the case of NFS
lock_migration.sh External Script for Lock Migration
These files are installed in the locations below:
$SGCONF/modules/tkit/<app>/<app>
$SGCONF/modules/tkit/<app>/<app>.1
$SGCONF/scripts/tkit/<app>/tkit_module.sh
$SGCONF/scripts/tkit/<app>/tkit_gen.sh
$SGCONF/scripts/tkit/nfs/lock_migration.sh
Where $SGCONF value for various Linux distributions is as given below:
RedHat : /usr/local/cmcluster/conf
SLES : /opt/cmcluster/conf
2