Sun Cluster 3.0 Data Services Installation and Configuration Guide

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:

Refer to scrgadm(1M) for additional information.

Perform this procedure from any cluster node.

  1. Become superuser on a node in the cluster.

  2. Add a scalable application resource to the resource group.


    # scrgadm -a -j resource-name -g resource-group-name -t resource-type-name \
    -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-name

    Specifies your choice of the name of the resource to add.

    -g resource-group-name

    Specifies the name of a scalable service resource group created previously.

    -t resource-type-name

    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 chapter for each data service to determine whether it is required.

    -y Standard_property=value, ...

    Specifies a comma-separated list of standard properties that depends on the particular data service. See the chapter for each data service and Appendix A, Standard Properties to determine whether it is required.


    Note -

    You can set additional properties. For information on other configurable properties, see Appendix A, Standard Properties and the chapter in this book on installing and configuring your scalable data service. Specifically for scalable services, you would normally set the Port_list, Load_balancing_weights, and Load_balancing_policy properties, which are described in Appendix A, Standard Properties.


  3. Verify that the scalable application resource has been added and validated.


    # scrgadm -pv -j resource-name
    

    The resource addition action causes the resource to be validated by the Sun Cluster software. If the validation succeeds, the resource can be enabled and the resource group can be moved into the state where it is managed by the RGM. 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 (ss-r-1) to a resource group (ss-rg-1). Note that ss-rg-1 depends on the failover resource group that contains the network addresses being used (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 defined previously.


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

Where to Go from Here

After adding a scalable application resource, enable it by following the procedure "How to Bring a Resource Group Online".