User's Manual

NOTE:
• This script does not include information about attached I/O devices, such as tape, DVD,
burner, and changer devices into the package configuration file.
• The VM guest must be running when you run the cmdeployvpkg command.
Managing packages
Running packages
To start the VM guest package use the following command:
# cmrunpkg <package_name>
Maintaining packages
When a package is set to the maintenance mode, the toolkit stops monitoring the status of the VM.
It enables you to perform the maintenance work on a VM guest without bringing down the package.
Maintenance mode is enabled only on the local node. Each time the maintenance mode is enabled
or disabled for the VM guest package, the event is logged in the package log file. If the
Serviceguard node on which the VM guest is running, fails when the maintenance mode is enabled,
the VM guest package fails over to a secondary node. Whether the changes made to the VM guest
or package configuration are distributed to the secondary node or not before the failover, depends
on the stage of the process where the failure occurred. After recovery, ensure that the VM guest
package is not in maintenance mode and the configuration is consistent for all nodes.
Perform the following steps to work with the package maintenance mode:
1. To enable the maintenance mode feature in the package configuration file, set the
MAINTENANCE_FLAG attribute to “yes”,and then apply the cmapplyconf command.
2. To start the maintenance mode for the package, run the command:
#cmdeployvpkg -m 1 -P <vm name>
3. To stop the maintenance mode and bring back the package in the running state, run the
command:
#cmdeployvpkg -m 0 -P <vm name>
NOTE:
• If the changes are made either to VM guest configuration environment or the Serviceguard
environment, HP recommends you to use the cmdeployvpkg command to package it again,
and then use the cmapplyconf command to reapply it.
• If the maintenance mode is not disabled, the VM guest package does not failover to the other
host when VM fails. HP recommends that you disable the maintenance mode each time after
the maintenance of the VM guest is complete.
Halting packages
To halt the package, run the following command:
# cmhaltpkg <package_name>
This command invokes the hpvmstop command on the specific VM to stop the package.
Deleting packages
To delete a package from the cluster, run the cmdeployvpkg command with -U option.
For example: #cmdeployvpkg -P vm1 -U
12 Using SG IVS toolkit