Go to main content

Planning and Administering Data Services for Oracle® Solaris Cluster 4.4

Exit Print View

Updated: November 2019
 
 

How to Add a Logical Hostname Resource to a Resource Group (clsetup)

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 browser interface to create in one operation a logical-hostname resource or a per-node logical hostname resource and a new resource group to contain it. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager in Administering an Oracle Solaris Cluster 4.4 Configuration. After you log in, click Tasks and then click Logical Hostname or Per-node Logical Hostname to start the wizard.

This wizard requires that all cluster nodes have the same root password.


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 PNM objects, the objects are configured on the nodes where the logical hostname resource can be brought online. Public network management (PNM) objects include Internet Protocol network multipathing (IPMP) groups, trunk and datalink multipathing (DLMP) link aggregations, and VNICs that are directly backed by link aggregations.

  • Ensure that the /etc/netmasks file has IP-address subnet and netmask entries for all logical hostnames. If necessary, edit the /etc/netmasks file to add any missing entries.

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

    The clsetup main menu is displayed.

  3. Type the option number for data services.

    The Data Services menu is displayed.

  4. Type the option number for configuring the Logical Hostname resource.

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

  5. Verify that the prerequisites are met.

    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.
    • To select a subset of the listed nodes, type a comma-separated or space-separated list of the numbers that correspond to the nodes.
    • 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.

      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.

    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.
    • If more than one PNM object is configured for the specified logical hostname, the clsetup utility provides a screen where you can specify the PNM objects to use.

      Proceed to Step 9.

    • If only one PNM object is configured for the specified logical hostname, the clsetup utility lists the names of the Oracle Solaris Cluster objects that the utility will create.

      Skip to Step 10.

  9. Select from the list of available PNM objects one object for each cluster node.

    The clsetup utility lists the names of the Oracle Solaris Cluster objects that the utility will create.

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

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

    2. At the New Value prompt, type the new name.

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

  11. To confirm your selection of Oracle Solaris Cluster object names, type d.

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

  12. To create the configuration, type c.

    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.

  13. (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.

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

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

    # clresource show node_name-rg