How to Add a Scalable Application Resource to a Resource Group (Sun Cluster Data Services Planning and Administration Guide for Solaris OS)

Sun Cluster Data Services Planning and Administration Guide for Solaris OS

How to Add a Scalable Application Resource to a Resource Group

A scalable application resource is an application resource that uses shared addresses in a failover resource group.

To complete this procedure, you must supply the following information:

The name of the scalable resource group into which you are adding the resource
The name of the resource type for the resource
The shared address resources that the scalable service resource uses, which are the shared addresses that you previously included in a failover resource group

See the scrgadm(1M) man page for additional information.

Note –

Perform this procedure from any cluster node.

Become superuser on a cluster member.

Add a scalable application resource to the resource group.

# scrgadm -a -j resource -g resource-group -t resource-type \
-y Network_resources_used=network-resource[,network-resource...] \
-y Scalable=True
[-x Extension_property=value, …] [-y Standard_property=value, …]

-a: Adds a resource.
-j resource: Specifies your choice of the name of the resource to add.
-g resource-group: Specifies the name of a scalable service resource group that you previously created.
-t resource-type: Specifies the name of the resource type for this resource.
-y Network_resources_used= network-resource[,network-resource...]: Specifies the list of network resources (shared addresses) on which this resource depends.
-y Scalable=True: Specifies that this resource is scalable.
-x Extension_property=value, …: Specifies a comma-separated list of extension properties that depend on the particular data service. See the documentation for each data service to determine whether the data service requires this property.
-y Standard_property=value, …: Specifies a comma-separated list of standard properties that depends on the particular data service. See the documentation for each data service and Appendix A, Standard Properties to determine whether the data service requires this property.
-y Standard_property=value, …: Specifies a comma-separated list of standard properties that depends on the particular data service. See the documentation for each data service and Appendix A, Standard Properties to determine whether the data service requires this property.

Note –

You can set additional properties. See Appendix A, Standard Properties and the documentation in this book on how to install and configure your scalable data service for information on other configurable properties. Specifically for scalable services, you typically set the Port_list, Load_balancing_weights, and Load_balancing_policy properties, which Appendix A, Standard Properties describes.

Verify that the scalable application resource has been added and validated.
# scrgadm -pv -j resource
Adding the resource causes the Sun Cluster software to validate the resource. If the validation succeeds, you can enable the resource, and you can move the resource group into the state where the RGM manages it. If the validation fails, the scrgadm command produces an error message and exits. If the validation fails, check the syslog on each node for an error message. The message appears on the node that performed the validation, not necessarily the node on which you ran the scrgadm command.

Example – Adding a Scalable Application Resource to a Resource Group

This example shows the addition of a resource (resource-1) to a resource group (resource-group-1). Note that resource-group-1 depends on the failover resource group that contains the network addresses that are in use (schost-1 and schost-2 in the following example). The resource depends on shared address resources (schost-1, schost-2), which must reside in one or more failover resource groups that you defined previously.

# scrgadm -a -j resource-1 -g resource-group-1 -t resource-type-1 \
-y Network_resources_used=schost-1,schost-2 \
-y Scalable=True
# scrgadm -pv -j resource-1
(resource-group-1) Res name:                                resource-1
    (resource-group-1:resource-1) Res R_description:
    (resource-group-1:resource-1) Res resource type:        resource-type-1
    (resource-group-1:resource-1) Res resource group name:  resource-group-1
    (resource-group-1:resource-1) Res enabled:              False
    (resource-group-1:resource-1) Res monitor enabled:      True

Where to Go From Here

After you add a scalable application resource, follow the procedure How to Bring Online Resource Groups to enable the resource.