Tivoli Header

Administrator's Reference

REGISTER ADMIN (Register an Administrator)

Use this command to add an administrator to the server. After registration, the administrator can issue a limited set of commands, including all query commands. To provide additional privileges, use the GRANT AUTHORITY command.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-REGister Admin--admin_name--password--+------------------+--->
                                         '-PASSExp--=--days-'
 
                         .-FORCEPwreset--=--No------.
>--+------------------+--+--------------------------+----------><
   '-CONtact--=--text-'  '-FORCEPwreset--=--+-No--+-'
                                            '-Yes-'

Parameters

admin_name (Required)

Specifies the name of the administrator to be registered. The maximum length of the name is 64 characters.

You cannot specify an adminstrator name of NONE.

password (Required)

Specifies the password of the administrator to be registered. The maximum length of the password is 64 characters. The password is not case-sensitive. See Naming Conventions in Tivoli Storage Manager for a table that lists the characters available for specifying a password.

PASSExp

Specifies the number of days the password remains valid. You can set the password expiration period from 0 to 9999 days. A value of 0 means that the password never expires. This parameter is optional. If you do not specify this parameter, the password is set with the global expiration period of 90 days.

CONtact

Specifies information identifying the administrator being registered. This parameter is optional. The maximum length of this string is 255 characters. The contact information must be enclosed in quotation marks if it contains any blanks.

FORCEPwreset

Specifies whether the administrator is required to change or reset the password. This parameter is optional. The default value is NO. Possible values are:

No: Specifies that the administrator does not need to change or reset the password while attempting to sign on to the server.
Yes: Specifies that the administrator's password will expire at the next sign-on. The client or administrator must change or reset the password at that time. If a password is not specified, you will receive an error message.

Examples

Task

Define an administrator, LARRY, with the password PASSONE. You can identify LARRY as second-shift personnel by specifying this information with the CONTACT parameter.

Command:: register admin larry passone contact='second shift'

Related Commands

Table 224. Commands Related to REGISTER ADMIN

Command	Description
GRANT AUTHORITY	Assigns privilege classes to an administrator.
LOCK ADMIN	Prevents an administrator from accessing Tivoli Storage Manager.
QUERY ADMIN	Displays information about one or more Tivoli Storage Manager administrators.
REGISTER NODE	Defines a client to the server and sets options for that user.
REMOVE ADMIN	Removes an administrator from the list of registered administrators.
RENAME ADMIN	Changes a Tivoli Storage Manager administrator's name.
SET PASSEXP	Specifies the number of days after which a password is expired and must be changed.
UNLOCK ADMIN	Enables a locked administrator to access Tivoli Storage Manager.
UPDATE ADMIN	Changes the password or contact information associated with any administrator.
UPDATE NODE	Changes the attributes associated with a client node.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]