RENAME NODE (Rename a node)

Use this command to rename a node.

If you are assigning an existing node ID to another person, use the UPDATE NODE command to change the password.

For users of Lightweight Directory Access Protocol (LDAP) servers:
  • The information in this documentation applies to the LDAP authentication method that is preferred for IBM Spectrum Protect V7.1.7 or later servers. For instructions about using the previous LDAP authentication method, see Managing passwords and logon procedures.
  • Do not rename a node to match an existing administrative user ID. If you rename a node, and the node name matches an administrative user ID, you might see unexpected behavior because of automatic password changes that update the same password twice. As a result, the password might become unknown to the administrative user ID. Alternatively, the password update might fail.
Restrictions:
  • You cannot rename a NAS node name that has a corresponding data mover defined. If the data mover has defined paths, the paths must first be deleted.
  • If a node is configured for replication, it cannot be renamed.

If you rename a node to the same name as an existing administrator, the administrator authentication method and SSLREQUIRED setting are updated to match the node. When a node and an administrator share a name and you change the node authentication method or the node SSLREQUIRED setting, the administrator settings also change. You must have system level authority to update the node authentication method or the node SSLREQUIRED setting and also update a same-named administrator.

Privilege class

You must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the client node is assigned.

Syntax

Read syntax diagramSkip visual syntax diagramREName Nodecurrent_node_namenew_node_name SYNCldapdelete=NoSYNCldapdelete=NoYes

Parameters

current_node_name (Required)
Specifies the name of the node to be renamed.
new_node_name (Required)
Specifies the new name of the node. The maximum length is 64 characters.
SYNCldapdelete
Specifies whether the node name is deleted and replaced on the Lightweight Directory Access Protocol (LDAP) server.
Yes
Specifies that the node name is deleted and replaced.
Restriction: Do not specify a value of YES. (The value of YES is appropriate only for users of the previous LDAP authentication method, which is described in Managing passwords and logon procedures.)
No
Specifies that the node name is not deleted and replaced. This is the default value.

Example: Rename a node

Rename the node JOE to JOYCE.
rename node joe joyce

Example: Rename a node that shares a namespace with other servers

Rename the node JOYCE to JOE and do not delete the previous name from corresponding LDAP servers.
rename node joyce joe

Related commands

Table 1. Commands related to RENAME NODE
Command Description
QUERY NODE Displays partial or complete information about one or more clients.
UPDATE NODE Changes the attributes that are associated with a client node.