Oracle® Solaris Cluster System Administration Guide

Exit Print View

Updated: October 2015

How to Rename a Node

You can change the name of a node that is part of an Oracle Solaris Cluster configuration. You must rename the Oracle Solaris hostname before you can rename the node. Use the clnode rename command to rename the node.

The following instructions apply to any application that is running in a global cluster.

  1. On the global cluster, assume a role that provides solaris.cluster.modify RBAC authorization.
  2. (Optional) If you are renaming a node in an Oracle Solaris Cluster Geographic Edition cluster that is in a partnership, determine whether to switch over the protection group.

    If the cluster where you are performing the rename procedure is primary for the protection group, and you want to have the application in the protection group online, you can switch the protection group to the secondary cluster during the rename procedure.

    For more information on Geographic Edition clusters and nodes, see Chapter 5, Administering Cluster Partnerships, in Oracle Solaris Cluster Geographic Edition System Administration Guide .

  3. Rename the Oracle Solaris host names by completing the steps in How to Change a System’s Identity in Managing System Information, Processes, and Performance in Oracle Solaris 11.2 , except do not perform a reboot at the end of the procedure.

    Instead, perform a cluster shutdown after you complete these steps.

  4. Boot all cluster nodes into noncluster mode.
    ok> boot -x
  5. In noncluster mode on the node where you renamed the Oracle Solaris hostname, rename the node and run the cmd command on each renamed host.

    Rename one node at a time.

    # clnode rename -n newnodename oldnodename
  6. Update any existing references to the previous hostname in the applications that run on the cluster.
  7. Confirm that the node was renamed by checking the command messages and log files.
  8. Reboot all nodes into cluster mode.
    # sync;sync;sync;reboot
  9. Verify the node displays the new name.
    # clnode status -v
  10. Update your Geographic Edition configuration to use the new cluster node name.

    The configuration information used by the protection groups and your data replication product might specify the node name.

  11. You can choose to change the logical hostname resources' hostnamelist property.

    See How to Change the Logical Hostnames Used by Existing Oracle Solaris Cluster Logical Hostname Resources for instructions on this optional step.