Managing Serviceguard A.11.20, March 2013

Getting and Setting the Status/Value of a Simple/Extended Generic Resource
You can use the Serviceguard commands cmgetresource(1m) and cmsetresource(1m),
respectively, to get or set the status of a simple generic resource or the value of an extended generic
resource. These commands can also be used in the monitoring script or executed from the CLI. You
must be a root user (UID=0) to execute these commands. Non-root users cannot run these commands.
Using Serviceguard Command to Get the Status/Value of a Simple/Extended Generic Resource
Use the cmgetresource command to get the status of a simple generic resource or the value of
an extended generic resource. For example:
cmgetresource -r sfm_disk
This retrieves the status of the generic resource sfm_disk if it is configured as a simple resource.
If configured as an extended resource, the value is returned.
Using Serviceguard Command to Set the Status/Value of a Simple/Extended Generic Resource
Use the cmsetresource command to set the status of a simple generic resource or the value of
an extended generic resource. For example:
cmsetresource -r sfm_disk -s up
This sets the status of the generic resource sfm_disk to up. This is a simple generic resource and
only the status can be set to up/down.
cmsetresource -r sfm_lan 10
This sets the current value of the generic resource sfm_lan to 10. This is an extended generic
resource and only numeric values from 1 to 2147483647 can be set.
See the man pages for more information.
Online Reconfiguration of Generic Resources
Online operations such as addition, deletion, and modification of generic resources in packages
are supported. The operations that can be performed online are:
• Addition of a generic resource of generic_resource_evaluation_type set to
during_package_start, if the status of the generic resource is not 'down'.
Please ensure that while adding a generic resource, the equivalent monitor is available; if not
add the monitor while adding a generic resource.
• Addition of a generic resource of generic_resource_evaluation_type set to
before_package_start, whose status is 'up'.
• Deletion of a generic resource. Please ensure that while deleting a generic resource, the
equivalent monitor is also removed. However, if a common resource is being monitored across
multiple packages, then before removing the monitor ensure that the generic resource being
deleted is not configured in other packages that are also using this monitor.
• Modification of generic_resource_evaluation_type from before_package_start
to during_package_start or vice versa when the resource is 'up'.
• Modification of generic_resource_up_criteria specified for resources of evaluation
type before_package_start or during_package_start provided the new up criteria
does not cause the resource status to evaluate to 'down' (i.e., the current_value of the resource
still satisfies the new up_criteria).
• Modification of resource type from a simple resource to an extended resource is allowed only
if the generic_resource_evaluation_type is during_package_start in all the
running packages that currently use the resource.
Package Configuration Planning 141