Oracle® Solaris Cluster Data Services Planning and Administration Guide

Exit Print View

Updated: September 2014, E39648–02
 
 

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 Oracle Solaris Cluster maintenance commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical.


Note -  You can also use the Oracle Solaris Cluster Manager GUI to create in one operation a logical-hostname resource a new resource group to contain it. For GUI log-in instructions, see How to Access Oracle Solaris Cluster Manager in Oracle Solaris Cluster System Administration Guide . After you log in, click Tasks and then click Logical Hostname to start the wizard.

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.

Ensure that you have the logical hostnames that you plan to add to the resource group.

  1. Assume the root role on any cluster node.
  2. Start the clsetup utility.
    # clsetup

    The clsetup main menu is displayed.

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

    The Data Services menu is displayed.

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

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

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

    The clsetup utility provides 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 and 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 provides 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 lists the names of the Oracle Solaris Cluster objects that the utility will create.

  9. If you require a different name for any Oracle Solaris Cluster object, change the name as follows.
    1. Type the number for the name that you are changing and press Return.

      The clsetup utility provides 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 Oracle Solaris Cluster objects that the utility will create.

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

    The clsetup utility provides information about the Oracle Solaris Cluster configuration that the utility will create.

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

    The clsetup utility provides a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility lists 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