IBM Tivoli Storage Manager, Version 7.1

RENAME NODE (Rename a node)

Use this command to rename a node.

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

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. For details on the steps that are required when you want to rename a NAS node, refer to the Administrator's Guide.
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


>>-REName Node--current_node_name--new_node_name---------------->

   .-SYNCldapdelete--=--No------.   
>--+----------------------------+------------------------------><
   '-SYNCldapdelete--=--+-No--+-'   
                        '-Yes-'

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 of the name is 64 characters.

SYNCldapdelete

If the node ID is stored on the LDAP directory server, you can rename the entry on that server by specifying a value of YES. Do not rename the entry if it is used by another server that shares the same namespace on the LDAP directory server. This parameter applies to nodes that authenticate passwords with an LDAP directory server. The default is NO.

Yes: Select YES to delete the corresponding LDAP entry in order to rename it. If you want to rename all of the same-named nodes to keep them in synch with the LDAP server, select YES.
No: Does not delete the corresponding entries. Select NO if the corresponding entries are being used by another server that shares administrative namespace in the LDAP directory server. Select NO if you want to rename only one node and keep the same-named nodes on the shared LDAP server, the same. After submitting the command, issue the UPDATE NODE AUTHENTICATION=LDAP command to create an LDAP entry for the new node name. Updating the node this way guarantees that the node can authenticate against the LDAP directory server. The default is NO.

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 directory servers. Specify SYNCLDAPDELETE=NO to ensure that other servers that share a namespace on the LDAP directory server can still connect to the LDAP directory server.

rename node joyce joe syncldapdelete=no

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 associated with a client node.

Feedback