Managing Serviceguard Nineteenth Edition, Reprinted June 2011

Dependency Rules for a Package in Maintenance Mode or Partial-Startup Maintenance Mode
You cannot configure new dependencies involving a package running in maintenance mode, and
in addition the following rules apply (we'll call the package in maintenance mode pkgA).
• The packages that depend on pkgA must be down with package switching disabled when
you place pkgA in maintenance mode. This applies to all types of dependency (including
exclusionary dependencies) as described under “About Package Dependencies” (page 128).
◦ You cannot enable a package that depends on pkgA.
◦ You cannot run a package that depends on pkgA, unless the dependent package itself
is in maintenance mode.
• Dependency rules governing packages that pkgA depends on to be UP are bypassed so that
these packages can halt and fail over as necessary while pkgA is in maintenance mode.
• If both packages in a dependency relationship are in maintenance mode, dependency rules
are ignored for those two packages.
For example, both packages in an exclusionary dependency can be run and halted in
maintenance mode at the same time.
Performing Maintenance Using Maintenance Mode
You can put a package in maintenance mode, perform maintenance, and take it out of maintenance
mode, whether the package is down or running.
This mode is mainly useful for making modifications to networking or EMS resources. To modify
other components of the package, such as services or storage, follow the additional rules and
instructions under “Performing Maintenance Using Partial-Startup Maintenance Mode” (page 276).
If you want to reconfigure the package (using cmapplyconf (1m)) see “Reconfiguring a Package”
(page 297) and “Allowable Package States During Reconfiguration ” (page 300).
Procedure
Follow these steps to perform maintenance on a package's networking or EMS components.
In this example, we'll call the package pkg1 and assume it is running on node1.
1. Place the package in maintenance mode:
cmmodpkg -m on -n node1 pkg1
2. Perform maintenance on the networks or resources and test manually that they are working
correctly.
NOTE: If you now run cmviewcl, you'll see that the STATUS of pkg1 is up and its STATE
is maintenance.
3. If everything is working as expected, take the package out of maintenance mode:
cmmodpkg -m off pkg1
Performing Maintenance Using Partial-Startup Maintenance Mode
To put a package in partial-startup maintenance mode, you put it in maintenance mode, then restart
it, running only those modules that you will not be working on.
Procedure
Follow this procedure to perform maintenance on a package. In this example, we'll assume a
package pkg1 is running on node1, and that we want to do maintenance on the package's
services.
276 Cluster and Package Maintenance