NAME | DESCRIPTION | ATTRIBUTES | SEE ALSO
SUNW.RGOffload describes a resource type that allows resources configured in failover resource groups to offload other specified resource groups.
This facility is most useful when the limited resources on cluster nodes prevent multiple data services from running simultaneously on a node. In such situations, a RGOffload resource in a resource group containing critical data services is configured to offload other resource groups.
You can use the scrgadm(1M) command or resource configuration GUI to add a RGOffload resource to the resource group containing critical data service resources, setup dependencies of the critical data service resources on this resource, and configure the resource groups to be offloaded from a node when critical data service resources are running on it. The dependencies ensure that the data service resources do not attempt to start on a node until the START method of the RGOffload resource has offloaded, or at least attempted to offload the specified resource groups from the node.
Resource groups specified to be offloaded must have their Desired_primaries property set to 0. The fault monitor of the SUNW.RGOffload resource will attempt to keep such resource groups online on as many healthy nodes as possible, limited by the Maximum_primaries property of individual resource groups. The fault monitor checks the status of specified resource groups on all nodes every Thorough_probe_interval.
When a data service resource is set up with a "strong dependency" upon a SUNW.RGOffload resource, the data service resource is not started on a node if there is a failure in offloading specified resource groups from that node. A data service resource set up with a "weak dependency" upon the SUNW.RGOffload resource may start when specified resource groups cannot be successfully offloaded from the node. An attempt would be made to offload the specified resource groups, but a failure in doing so will not prevent the startup of the data service resource.
See r_properties(5) for a complete description of the standard resource properties.
Type integer; defaults to 4. This property controls fault-monitor restarts. The property indicates the number of times that the process monitor facility (PMF) restarts the fault monitor. The property corresponds to the -n option passed to the pmfadm(1M) command. The RGM counts the number of restarts in a specified time window (see the property Monitor_retry_interval). Note that this property refers to the restarts of the fault monitor itself, not the SUNW.RGOffload resource. You can modify the value for this property at any time.
Type integer; defaults to 2. This property indicates the time window in minutes during which the RGM counts fault-monitor failures. The property corresponds to the -t option passed to the pmfadm(1M) command. If the number of times that the fault monitor fails exceeds the value of the extension property Monitor_retry_count, the PMF does not restart the fault monitor. You can modify the value for this property at any time.
Type string array, specified as a comma-separated list of resource groups. No default exists for this field. You must provide the value when creating the resource. This property indicates the list of resource groups to be offloaded. All resource groups in this property must have Desired_primaries set to 0. rg_to_offload should not contain the resource group in which the RGOffload resource is being configured. rg_to_offload should also not contain resource groups dependent upon each other. For example, if resource group RG-B depends on resource group RG-A, then both, RG-A and RG-B should not be configured in this extension property. SUNW.RGOffload resource type does not check for dependencies among resource groups in the rg_to_offload extension property. You can modify the value of this property at any time.
Type boolean; defaults to TRUE. This property indicates whether to continue offloading the next resource group in the list specified in the rg_to_offload property in case of error in offloading any resource group. You can modify the value of this property at any time.
Type integer; defaults to 15. This property indicates the number of attempts during the startup of RGOffload resource to offload a resource group specified in the rg_to_offload property if there is a failure due to cluster or resource group reconfiguration. This value applies to all resource groups in the rg_to_offload property. When the value of this property is greater than 0, successive attempts to offload the same resource group would be made after approximately 10 second intervals. You can modify the value of this property at any time.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWrgofl |
pmfadm(1M), scha_resource_get(1HA), scrgadm(1M), scswitch(1M), scha_cluster_get(3HA), scha_resourcegroup_get(3HA) , attributes(5), r_properties(5)
Sun Cluster Data Services Installation and Configuration Guide
NAME | DESCRIPTION | ATTRIBUTES | SEE ALSO