Skip to main content

system node rename

Contributors
Suggest changes

Rename a node

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The system node rename command changes a node's name. Both the node to be modified and the new name of that node must be specified with the following parameters. This command is best executed from the node that is being renamed, using the -node local parameter.

Use the system node show command to display the names of all the nodes in the current cluster.

Parameters

-node {<nodename>|local} - Node

This parameter specifies which node you are renaming. The value local specifies the current node.

-newname <text> - New Name

Use this parameter to specify the new name of the node.

  • The name must contain only the following characters: A-Z, a-z, 0-9, "-" or "_".

  • The first character must be one of the following characters: A-Z or a-z.

  • The last character must be one of the following characters: A-Z, a-z or 0-9.

  • The maximum supported length is 47 characters.

  • The system reserves the following names: "all", "cluster", "local" and "localhost".

Examples

The following example changes the name of the node named node3 to node4.

cluster1::> system node rename -node node3 -newname node4