PowerHA policies for cluster administrative domain resources

Easily manage adding, deleting, and restoring resources to nodes in the cluster administrative domain using PowerHA policies

In an environment running IBM® PowerHA® SystemMirror® for i, PowerHA policies for cluster administrative domain resources provide users with a single point of control for management of resources in the administrative domain. Resources that were added manually or using scripts calling the ADDCADMRE command now can be created and managed automatically with the PowerHA policies for the cluster administrative domain resources.

The PowerHA policies for administrative domain resources are:
QCST_AD_CREATE
The QCST_AD_CREATE policy specifies which resources will be automatically added to the specified cluster administrative domain when the resource is created. Normally, resources must be manually added to the cluster administrative domain after they are created. If a QCST_AD_CREATE policy is specified for a resource type and a resource of that type is created, a monitored resource entry (MRE) will be automatically created for the resource. This MRE will monitor all of the attributes for the resource.
QCST_AD_DELETE
The QCST_AD_DELETE policy automates and simplifies management of the removal of monitored resources and their respective MREs from a cluster. If an administrative domain uses the QCST_AD_DELETE policy with its monitored resources, then a resource deleted on one node of the cluster administrative domain can be deleted on all other active cluster nodes. Once the resource has been deleted on all cluster nodes, the MRE for the resource is also removed from the cluster administrative domain.
QCST_AD_ RESTORE
The QCST_AD_RESTORE high availability policy streamlines resource attribute updates when restoring monitored resources. Normally, resources with a MRE in the cluster administrative domain which are restored are immediately updated to match the attribute values in the cluster administrative domain, essentially ignoring the restore operation. The QCST_AD_RESTORE policy specifies which resources, or resource types will honor restore operations in the specified cluster administrative domain. When the QCST_AD_RESTORE policy is specified the restored version of the attribute values will be propagated to other nodes in the cluster administrative domain.
The QCST_AS_RESTORE PowerHA policy only applies to MREs that exist in the administrative domain at the time of the restore. MREs are not added to the administrative domain as a result of this policy.

Configuring a PowerHA policy for administrative domain resources

Each PowerHA administrative domain resource policy is defined by the cluster administrative domain name specified in the domain name field and the resource type specified in the RSCTYPE keyword in the policy qualifier field. The name of any defined cluster administrative domain resource type may be specified. In addition the special value *ALL can be specified for the resource type, indicating all resource types supported by that policy.

When configuring a PowerHA policy for the cluster administrative domain you need:
  • a specific PowerHA policy name, for example, QCST_AD_CREATE.
  • the name of the administrative domain the policy will apply to.
  • the names of the resource type or types that the policy will create resource entries for.
  • Note: depending on the type, you may require a list of libraries.
With this information available, you can create or configure an PowerHA policy in your admin domain.

The PowerHA administrative domain resource policies qualifiers and values

PowerHA policies for administrative domain resources contain policy qualifiers designated as resource types (RSCTYPE). Supported resource types and the associated policy values are listed in Table 1 below:

Table 1. Table of qualifier resource types and their possible policy values
Policy qualifier Policy value Notes
RSCTYPE(*ALL)
  • LIB(*ALL)
  • LIB(NAME1 NAME2...)
 
RSCTYPE(*ASPDEV) *BLANK  
RSCTYPE(*AUTL) *BLANK  
RSCTYPE(*CLS)
  • LIB(*ALL)
  • LIB(NAME1 NAME2...)
 
RSCTYPE(*ENVVAR) *BLANK This resource type is supported by QCST_AD_DELETE only
RSCTYPE(*ETHLIN) *BLANK  
RSCTYPE(*JOBD)
  • LIB(*ALL)
  • LIB(NAME1 NAME2...)
 
RSCTYPE(*OPTDEV) *BLANK  
RSCTYPE(*PRTDEV) *BLANK  
RSCTYPE(*SBSD)
  • LIB(*ALL)
  • LIB(NAME1 NAME2...)
 
RSCTYPE(*TAPDEV) *BLANK  
RSCTYPE(*USTPRF) *BLANK  
Policy value definitions.
LIB(*ALL)
indicating that the resource type can be created in any library.
*BLANK
indicating that the resource type does not require any library.
LIB(NAME1 NAME2...)
using only resources contained in the specified libraries.
Important:
  1. If LIB(*ALL) is specified with the RSCTYPE(*ALL) policy qualifier the policy will cover all resource types, whether or not the resource type requires a library.
  2. Objects restored to the system are not covered under the QCST_AD_CREATE PowerHA policy.
  3. The QCST_AD_CREATE policy only affects resources created on active cluster nodes in a cluster that is not partitioned.

Examples

This example defines an instance of the QCST_AD_CREATE PowerHA policy used in the policy domain, ADMINDMN:
ADDHAPCY PCY(QCST_AD_CREATE) PCYDMN(ADMINDMN) QUAL('RSCTYPE(*ASPDEV)') VALUE(*BLANK)
This policy ensures that when a resource type (RSCTYPE) of ASP device description is created in policy domain, a MRE assigned to it is created in the administrative domain ADMINDMN.