IBM Tivoli Storage Manager, Version 7.1

RENAME ADMIN (Rename an administrator)

Use this command to change the name of an existing administrator. Existing information for this administrator such as password, contact information, and privilege classes is not altered.

If you assign an existing administrative user ID to another person, it is recommended that you use the UPDATE ADMIN command to change the password.

When an administrator and a node share a name and you change the administrator authentication method, the node authentication method also changes. If you rename an administrator to the same name as an existing node, the authentication method and the SSLREQUIRED setting for the node can change. If those settings are different, after the renaming, both administrator and node will have the same authentication method and SSLREQUIRED setting.

You cannot rename the SERVER_CONSOLE administrative ID.

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-REName Admin--current_admin_name--new_admin_name------------->

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

Parameters

current_admin_name (Required)

Specifies the name of the administrator user ID to be renamed.

new_admin_name (Required)

Specifies the new administrator name. The maximum length of the name is 64 characters.

SYNCldapdelete

If the administrative user 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 administrator namespace on the 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 administrators 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 administrator and have the administrators on the shared LDAP server keep their same name. After submitting the command, issue the UPDATE ADMIN AUTHENTICATION=LDAP command to create an LDAP entry for the new administrator name. Updating the administrator this way guarantees that the administrator can authenticate against the LDAP directory server. The default is NO.

Example: Rename an administrator

Rename the Tivoli® Storage Manager administrator CLAUDIA to BILL.

rename admin claudia bill

Example: Rename an administrator and all same-named administrators that authenticate to an LDAP server

rename admin claudia bill syncldapdelete=yes

Related commands

Table 1. Commands related to RENAME ADMIN
Command	Description
QUERY ADMIN	Displays information about one or more Tivoli Storage Manager administrators.
UPDATE ADMIN	Changes the password or contact information associated with any administrator.

Feedback