How to Add a Logical Hostname Resource to a Resource Group by Using the clsetup Utility

The following instructions explain how to add a logical hostname resource to a resource group by using the clsetup utility. Perform this procedure from one node only.

This procedure provides the long forms of the Sun Cluster maintenance commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

Before You Begin

Ensure that the following prerequisites are met:

• An entry for each logical hostname that is to be made available by the resource is added to the name service database.

• If you are using IP Networking Multipathing (IPMP) groups, the groups are configured on the nodes where the logical hostname resource can be brought online.

• Any global-cluster non-voting node that can master the resource is already configured on your cluster nodes.

Ensure that you have the following information:

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

1. Become superuser on any cluster node.

2. Start the clsetup utility.

   # clsetup

   The clsetup main menu is displayed.

3. Type the number that corresponds to the option for data services and press Return.

   The Data Services menu is displayed.

4. Type the number that corresponds to the option for configuring the Logical Hostname resource and press Return.

   The clsetup utility displays the list of prerequisites for performing this task.

5. Verify that the prerequisites are met, and press Return to continue.

   The clsetup utility displays a list of the cluster nodes where the logical hostname resource can be brought online.

6. Select the nodes where the logical hostname resource can be brought online.

   • To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.

   • To select a subset of the listed nodes, type a comma-separated or space-separated list of the numbers that correspond to the nodes. Then press Return.

   • To select all nodes in a particular order, type a comma-separated or space-separated ordered list of the numbers that correspond to the nodes and press Return.

     Ensure that the nodes are listed in the order in which the nodes are to appear in the logical hostname resource group's node list. The first node in the list is the primary node of this resource group.

7. To confirm your selection of nodes, type d and press Return.

   The clsetup utility displays a screen where you can specify the logical hostname that the resource is to make available.

8. Type the logical hostname that this resource is to make available and press Return.

   The clsetup utility displays the names of the Sun Cluster objects that the utility will create.

9. If you require a different name for any Sun Cluster object, change the name as follows.

   1. Type the number that corresponds to the name that you are changing and press Return.

      The clsetup utility displays a screen where you can specify the new name.

   2. At the New Value prompt, type the new name and press Return.

   The clsetup utility returns you to the list of the names of the Sun Cluster objects that the utility will create.

10. To confirm your selection of Sun Cluster object names, type d and press Return.

    The clsetup utility displays information about the Sun Cluster configuration that the utility will create.

11. To create the configuration, type c and press Return.

    The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.

12. (Optional) Type q and press Return repeatedly until you quit the clsetup utility.

    If you prefer, you can leave the clsetup utility running while you perform other required tasks before using the utility again. If you choose to quit clsetup, the utility recognizes your existing logical hostname resource group when you restart the utility.

13. Verify that the logical hostname resource has been created.

    Use the clresource(1CL) utility for this purpose. By default, the clsetup utility assigns the name node_name-rg to the resource group.

    # clresource show node_name-rg