Adding Resources to Resource Groups

A resource is an instantiation of a resource type. You must add resources to a resource group before the RGM can manage the resources. This section describes the following three resource types.

• Logical hostname resources

• Shared-address resources

• Data service (application) resources

Always add logical hostname resources and shared address resources to failover resource groups. Add data service resources for failover data services to failover resource groups. Failover resource groups contain both the logical hostname resources and the application resources for the data service. Scalable resource groups contain only the application resources for scalable services. The shared address resources on which the scalable service depends must reside in a separate failover resource group. You must specify dependencies between the scalable application resources and the shared address resources for the data service to scale across cluster nodes.

For more information about resources, see Sun Cluster Concepts Guide for Solaris OS and Chapter 1, Planning for Sun Cluster Data Services.

How to Add a Logical Hostname Resource to a Resource Group

When you add a logical hostname resource to a resource group, the extension properties of the resource are set to their default values. To specify a nondefault value, you must modify the resource after you add the resource to a resource group. For more information, see How to Modify a Logical Hostname Resource or a Shared Address Resource.

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the failover resource group to which you are adding the resource

• The hostnames that you plan to add to the resource group

Steps

1. Become superuser on a cluster member.

2. Add the logical hostname resource to the resource group.

   # scrgadm -a -L [-j resource] -g resource-group -l hostnamelist, … [-n netiflist]

   -a

   Adds a logical hostname resource.

   -L

   Specifies the logical hostname resource form of the command.

   -j resource

   Specifies an optional resource name of your choice. If you do not specify this option, the name defaults to the first hostname that is specified with the -l option.

   -g resource-group

   Specifies the name of the resource group in which this resource resides.

   -l hostnamelist, …

   Specifies a comma-separated list of UNIX hostnames (logical hostnames) by which clients communicate with services in the resource group.

   -n netiflist

   Specifies an optional, comma-separated list that identifies the IP Networking Multipathing groups that are on each node. Each element in netiflist must be in the form of netif@node. netif can be given as an IP Networking Multipathing group name, such as sc_ipmp0. The node can be identified by the node name or node ID, such as sc_ipmp0@1 or sc_ipmp@phys-schost-1.

   ---

   Note –

   Sun Cluster does not support the use of the adapter name for netif.

   ---

3. Verify that the logical hostname resource has been added.

   # scrgadm -pv -j resource

Example 2–6 Adding a Logical Hostname Resource to a Resource Group

This example shows the addition of logical hostname resource (resource-1) to a resource group (resource-group-1).

# scrgadm -a -L -j resource-1 -g resource-group-1 -l schost-1
# scrgadm -pv -j resource-1
Res Group name: resource-group-1
(resource-group-1) Res name:                              resource-1
  (resource-group-1:resource-1) Res R_description:
  (resource-group-1:resource-1) Res resource type:        SUNW.LogicalHostname
  (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

Example 2–7 Adding Logical Hostname Resources That Identify IP Networking Multipathing Groups

This example shows the addition of the following logical host name resources to the resource group nfs-fo-rg:

• A resource that is named cs23-rs, which identifies the IP Networking Multipathing group sc_ipmp0 on node 1 and node 2

• A resource that is named cs24-rs, which identifies the IP Networking Multipathing group sc_ipmp1 on node 1 and node 2

# scrgadm -a -L -j cs23-rs -g nfs-fo-rg -l cs23-rs -n sc_ipmp0@1,sc_ipmp0@2
# scrgadm -a -L -j cs24-rs -g nfs-fo-rg -l cs24-rs -n sc_ipmp1@1,sc_ipmp1@2

Next Steps

After you add logical hostname resources, use the procedure How to Bring Online Resource Groups to bring them online.

Troubleshooting

Adding a resource causes the Sun Cluster software to validate the resource. If the validation fails, the scrgadm command prints an error message and exits. To determine why the validation failed, 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.

See Also

The scrgadm(1M) man page.

How to Add a Shared Address Resource to a Resource Group

When you add a shared address resource to a resource group, the extension properties of the resource are set to their default values. To specify a nondefault value, you must modify the resource after you add the resource to a resource group. For more information, see How to Modify a Logical Hostname Resource or a Shared Address Resource.

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the resource group into which you are adding the resource. This group must be a failover resource group that you created previously.

• The hostnames that you plan to add to the resource group.

Steps

1. Become superuser on a cluster member.

2. Add the shared address resource to the resource group.

   # scrgadm -a -S [-j resource] -g resource-group -l hostnamelist, … \ [-X auxnodelist] [-n netiflist]

   -a

   Adds shared address resources.

   -S

   Specifies the shared address resource form of the command.

   -j resource

   Specifies an optional resource name of your choice. If you do not specify this option, the name defaults to the first hostname that is specified with the -l option.

   -g resource-group

   Specifies the resource group name.

   -l hostnamelist, …

   Specifies a comma-separated list of shared address hostnames.

   -X auxnodelist

   Specifies a comma-separated list of physical node names or IDs that identify the cluster nodes that can host the shared address but never serve as primary if failover occurs. These nodes are mutually exclusive, with the nodes identified as potential masters in the resource group's node list.

   -n netiflist

   Specifies an optional, comma-separated list that identifies the IP Networking Multipathing groups that are on each node. Each element in netiflist must be in the form of netif@node. netif can be given as an IP Networking Multipathing group name, such as sc_ipmp0. The node can be identified by the node name or node ID, such as sc_ipmp0@1 or sc_ipmp@phys-schost-1.

   ---

   Note –

   Sun Cluster does not support the use of the adapter name for netif.

   ---

3. Verify that the shared address resource has been added and validated.

   # scrgadm -pv -j resource

Example 2–8 Adding a Shared Address Resource to a Resource Group

This example shows the addition of a shared address resource (resource-1) to a resource group (resource-group-1).

# scrgadm -a -S -j resource-1 -g resource-group-1 -l schost-1
# 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:        SUNW.SharedAddress
    (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

Next Steps

After you add a shared-address resource, use the procedure How to Bring Online Resource Groups to enable the resource.

Troubleshooting

Adding a resource causes the Sun Cluster software to validate the resource. If the validation fails, the scrgadm command prints an error message and exits. To determine why the validation failed, 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.

See Also

The scrgadm(1M) man page.

How to Add a Failover Application Resource to a Resource Group

A failover application resource is an application resource that uses logical hostnames that you previously created in a failover resource group.

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the failover resource group to which you are adding the resource

• The name of the resource type for the resource

• The logical hostname resources that the application resource uses, which are the logical hostnames that you previously included in the same resource group

Steps

1. Become superuser on a cluster member.

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

   # scrgadm -a -j resource -g resource-group -t resource-type \ [-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 failover resource group. This resource group must already exist.

   -t resource-type

   Specifies the name of the resource type for the resource.

   -x extension-property=value, …

   Specifies a comma-separated list of extension properties that you are setting for the resource. The extension properties that you can set depend on the resource type. To determine which extension properties to set, see the documentation for the resource type.

   -y standard-property=value, …

   Specifies a comma-separated list of standard properties that you are setting for the resource. The standard properties that you can set depend on the resource type. To determine which standard properties to set, see the documentation for the resource type and Appendix A, Standard Properties.

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

   # scrgadm -pv -j resource

Example 2–9 Adding a Failover Application Resource to a Resource Group

This example shows the addition of a resource (resource-1) to a resource group (resource-group-1). The resource depends on logical hostname resources (schost-1, schost-2), which must reside in the same 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,schost2 \
# 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

Next Steps

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

Troubleshooting

Adding a resource causes the Sun Cluster software to validate the resource. If the validation fails, the scrgadm command prints an error message and exits. To determine why the validation failed, 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.

See Also

The scrgadm(1M) man page.

How to Add a Scalable Application Resource to a Resource Group

A scalable application resource is an application resource that uses shared-address resources. The shared-address resources are in a failover resource group.

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the scalable resource group to 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

Steps

1. Become superuser on a cluster member.

2. 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 you are setting for the resource. The extension properties that you can set depend on the resource type. To determine which extension properties to set, see the documentation for the resource type.

   -y standard-property=value, …

   Specifies a comma-separated list of standard properties that you are setting for the resource. The standard properties that you can set depend on the resource type. For scalable services, you typically set the Port_list, Load_balancing_weights, and Load_balancing_policy properties. To determine which standard properties to set, see the documentation for the resource type and Appendix A, Standard Properties.

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

   # scrgadm -pv -j resource

Example 2–10 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

Next Steps

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

Troubleshooting

Adding a resource causes the Sun Cluster software to validate the resource. If the validation fails, the scrgadm command prints an error message and exits. To determine why the validation failed, 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.

See Also

The scrgadm(1M) man page.