RENAME ADMIN (Rename an administrator)

Use this command to change an administrative user ID. 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, 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.

For users of Lightweight Directory Access Protocol (LDAP) servers:

The information in this documentation applies to the LDAP authentication method that is preferred for Tivoli® Storage Manager V7.1.7 or later servers. For instructions about using the previous LDAP authentication method, see Managing passwords and logon procedures.
Do not rename an administrative user ID to match a node name. If the names match, 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.

The following restrictions apply:

You cannot rename the SERVER_CONSOLE administrative ID.
You cannot use the RENAME ADMIN command to rename an administrative user ID that is defined on an LDAP server. (The LDAP administrator can change the administrative user ID on the LDAP server.)

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 administrative user ID to be renamed.

new_admin_name (Required)

Specifies the new administrative user ID. The maximum length of the name is 64 characters.

SYNCldapdelete

Specifies whether to delete the administrative user ID on the Lightweight Directory Access Protocol (LDAP) server and replace the ID with a new one.

Yes: Deletes the administrative user ID on the LDAP server and replaces it with a new ID.
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: Does not delete and replace the administrative user ID on the LDAP server. This is the default value.

Example: Rename an administrator

Rename the Tivoli Storage Manager administrator CLAUDIA to BILL.

rename admin claudia bill

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.