HP Serviceguard Developer's Toolbox Version B.12.00.00 For HP-UX and Linux

is stored in the PID file. That is, if the application for which this Toolkit is developed is
MySQL, then APP_SERVER_PROC mysqld.
• Toolkit Module Script (tkit_module.sh)
The Toolkit module script contains the following functions that support validation, starting,
stopping, and monitoring of application services:
◦ validate_function: validates parameters in the package environment.
◦ start_function: invokes the TKIT_APP_START script (to be developed by user) to start
the application.
◦ monitor_function: monitors the application based on the monitoring criteria provided.
When an application process that is being monitored fails, the function will set its status
to "failure" to be returned to Serviceguard so that appropriate action can be taken.
This function can monitor application integration using Serviceguard Developer's Toolbox
version B.12.00.00 based on the pid_file, process_monitor, or port_monitor.
You can choose any of these or implement your own monitoring function.
◦ stop_function: invokes the TKIT_APP_STOP script (to be developed by user) to stop the
application.
This script is called by the Serviceguard master control script to perform the following:
– On package startup, it starts the application service and keeps monitoring it.
– On package halt, it halts the monitoring process and stops the application.
This script returns “success” status to the Serviceguard master control script if it is
successful in performing the specified action; otherwise, it returns a non-zero value.
You must not make any changes to this script for integration.
You must implement the application start script (TKIT_APP_START) and stop script (TKIT_APP_STOP).
The guidelines for developing these modules are:
• APPLICATION START SCRIPT (TKIT_APP_START)
This script must be developed to perform the following:
◦ Validate the application start-up parameters
◦ Start the application with the specified configuration options
◦ Verify whether the start-up was successful, and return status to the Toolkit module script;
Success or 0 if the application started successfully, and Failure or 1 if the start-up failed.
• APPLICATION STOP SCRIPT (TKIT_APP_STOP)
This script must be developed to perform the following:
◦ Shutdown application services
◦ Return the status code to the Toolkit;
Success or 0 if the application was brought down gracefully, and Failure or 1 if the
application halt failed.
For sample Toolkit scripts see, “MySQL Toolkit scripts” (page 15).
Using the test tool
The test tool tests a given package for CHO. It continuously fails over the given package between
the nodes, and logs any errors reported.
Configuring Toolkits 13