How to Add a Logical Hostname Resource to a Resource Group

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

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

• The hostnames that you plan to add to the 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.

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

Perform this procedure from any cluster node.

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 currently support using the adapter name for netif.

   ---

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

   # 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 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

Where to Go From Here

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