Managing HP Serviceguard A.12.00.00 for Linux, June 2014

To handle the failure during online package reconfiguration, see “Handling Failures During Online
Package Reconfiguration”.
Recommendations
• HP recommends that when modifying package parameters online, the modification must be
done on one module at a time and also from one package only.
• You must consider only one package for online reconfiguration at a time.
• If you are adding a new module or a parameter when the package is UP, make the changes
in the Serviceguard package and later configure the application to use the changes.
For example, to add a mount point:
a. Edit the package configuration file and add the mount point.
b. Verify the package configuration file:
#cmcheckconf -P <pkg_name>
c. Apply the package configuration once the verification is successful:
#cmapplyconf -P <pkg_name>
d. Configure the application to use the mount point that is added.
• If you are deleting a module or parameter from the module, you must remove the configuration
from the application and later delete from the Serviceguard.
For example, to delete a mount point:
a. Remove the mount point from the application.
b. Edit the package configuration file and remove the mount point.
c. Verify the package configuration file:
#cmcheckconf -P <pkg_name>
d. Apply the package configuration once the verification is successful:
#cmapplyconf -P <pkg_name>
For limitations on online reconfiguration of serviceguard-xdc package, see “Online Reconfiguration
of serviceguard-xdc Modular Package Parameters”.
7.7.8.1 Handling Failures During Online Package Reconfiguration
During online package reconfiguration, if there are any failure the
online_modification_failed flag is set to yes and the following restrictions apply to the
package:
• The global switching of the package is disabled. This means, the package cannot failover to
the adoptive node. For more information, see cmviewcl (5) manpage.
• Live application detach (LAD) of the node where the package reconfiguration has failed are
not allowed.
• The package cannot be put into maintenance mode when an
online_modification_failed flag is set to yes.
• You cannot modify the package configuration online. For more information, see cmapplyconf
(1m) manpage.
The online_modification_failed flag can be cleared in one of the following ways:
• Halting the package using cmhaltpkg command. For more information, see cmhaltpkg
(1m) manpage.
• A new option -f is introduced for cmmodpkg command that can be used to clear the flag.
The -f option must be used after fixing the errors found during the previous online
7.7 Reconfiguring a Package 251