Go to main content

Administering an Oracle® Solaris Cluster 4.4 Configuration

Exit Print View

Updated: November 2019

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 authorization.
  2. (Optional) If you are renaming a node in a cluster that is in a disaster recovery framework 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 about administering clusters and nodes in a disaster recovery framework partnership, see Chapter 5, Administering Cluster Partnerships in Administering the Disaster Recovery Framework for Oracle Solaris Cluster 4.4.

  3. Rename the Oracle Solaris host names.

    Complete the steps in How to Change the Identity of a System in Managing System Information, Processes, and Performance in Oracle Solaris 11.4, 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 new-node old-node

    Note -  Update /etc/hosts to have the IP address resolve to both the old hostname and the new hostname temporarily on all cluster nodes.
    # ip-address new-node old-node   
    # clnode rename -n new-node old-node

    Once the clnode rename is complete, you can remove the old-node from /etc/host.

    # ip-address new-node

  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 disaster recovery framework 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.