Tivoli Storage Manager for Sun Solaris Administrator's Reference

REGISTER NODE (Register a Client Node)

Use this command to register a client node to the server.

This command also automatically creates an administrative user ID with client owner authority over the node. You can use this administrative user ID to access the Web backup-archive client from remote locations through a Web browser. If an administrative user ID already exists with the same name as the node being registered, an administrative user ID is not automatically defined. The client node is registered without an administrative user ID. This process also applies if your site uses open registration.

If a client requires a different policy domain than STANDARD, you must register the client node with this command or update the registered node.

Privilege Class

To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the client node is assigned.

Syntax

>>-REGister Node--node_name--password----+-------------------+-->
                                         '-PASSExp--=--days--'
 
      .-USerid--=--node_name---.
>-----+------------------------+---+-------------------+-------->
      '-USerid--=--+-NONE----+-'   '-CONtact--=--text--'
                   '-user_id-'
 
>-----+-------------------------+------------------------------->
      '-DOmain--=--domain_name--'
 
      .-COMPression--=--Client-----.
>-----+----------------------------+---------------------------->
      '-COMPression--=--+-Client-+-'
                        +-Yes----+
                        '-No-----'
 
      .-ARCHDELete--=--Yes-----.   .-BACKDELete--=--No------.
>-----+------------------------+---+------------------------+--->
      '-ARCHDELete--=--+-Yes-+-'   '-BACKDELete--=--+-No--+-'
                       '-No--'                      '-Yes-'
 
>-----+-------------------------------+------------------------->
      '-CLOptset--=--option_set_name--'
 
      .-FORCEPwreset--=--No------.   .-Type--=--Client-----.
>-----+--------------------------+---+---------------------+---->
      '-FORCEPwreset--=--+-No--+-'   '-Type--=--+-Server-+-'
                         '-Yes-'                '-Client-'
 
                         .-KEEPMP--=--No------.
>-----+--------------+---+--------------------+----------------->
      '-URL--=--url--'   '-KEEPMP--=--+-No--+-'
                                      '-Yes-'
 
      .-MAXNUMMP--=--1-------.
>-----+----------------------+---------------------------------><
      '-MAXNUMMP--=--number--'
 

Parameters

node_name (Required)
Specifies the name of the client node to be registered. The maximum length of the name is 64 characters.

You cannot specify a node name of NONE.

password (Required)
Specifies the client node's password. The maximum length of the name 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.

USerid
Specifies the administrative user ID with client owner authority. If you do not specify a user ID, by default an administrative user ID with client owner authority is created using the nodename of the client node to be registered. This parameter is optional. When PASSWORDACCESS=GENERATE is used by the client to change the password, the administrative ID with the same name can be used to access the web backup-archive client from a remote location. Possible values are:

NONE
Specifies that an administrative user ID will not be automatically defined.

otheruserid
Specifies a node ID different than the node being registered. You can use this parameter to grant client owner authority to an existing administrative user ID.

CONtact
Specifies a text string of information identifying the node. The parameter is optional. The maximum length of the text string is 255 characters. The contact information must be enclosed in quotation marks if it contains any blanks.

DOmain
Specifies the name of the policy domain to which the node is assigned. The parameter is optional. If you do not specify a policy domain name, the node is assigned to the default policy domain (STANDARD).

When a source server is registered as a node, it is assigned to a policy domain. Data from the source server is stored in the storage pool specified in the archive copy group of the default management class of that domain.

COMPression
Specifies whether the client node compresses its files before sending them to the server for backup and archive. The parameter is optional. The default value is CLIENT. Possible values are:

Client
Specifies that the client determines whether to compress files.

Yes
Specifies that the client node compresses its files before sending them to the server for backup and archive.

No
Specifies that the client node does not compress its files before sending them to the server for backup and archive.

ARCHDELete
Specifies whether the client node can delete its own archive files from the server. The parameter is optional. The default value is YES. Possible values are:

Yes
Specifies that the client node can delete its own archive files from the server.

No
Specifies that the client node cannot delete its own archive files from the server.

BACKDELete
Specifies whether the client node can delete its own backup files from the server. The parameter is optional. The default value is NO. Possible values are:

No
Specifies that the client node cannot delete its own backup files from the server.

Yes
Specifies that the client node can delete its own backup files from the server.

CLOptset
Specifies the name of the option set to be used by the client. The parameter is optional.

FORCEPwreset
Specifies whether to force a client to change or reset the password. The parameter is optional. The default value is NO. Possible values are:

No
Specifies that the password expiration period is set by the SET PASSEXP command. The client does not need to change or reset the password while attempting to logon to the server.

Yes
Specifies that the client node password will expire at the next logon. The client must change or reset the password at that time. If a password is not specified, you will receive an error message.

Type
Specifies the type of node being registered. The parameter is optional. The default value is CLIENT. Possible values are:

Client
Specifies that the client node is a backup-archive or HSM client.

Server
Specifies that the client node is a source server being registered on the target server.

URL
Specifies the URL address that is used in your Web browser to administer the TSM client. The parameter is optional.

KEEPMP
Specifies whether the client node keeps the mount point for the entire session. The parameter is optional. The default value is NO. Possible values are:

Yes
Specifies that the client node must retain the mount point during the entire session. If policy definitions cause data to be stored to a disk storage pool after storing data to a sequential access storage pool, any mount points held by the session will not be released.

No
Specifies that the client node release the mount point during the session. If policy definitions cause data to be stored to a disk storage pool after storing data to a sequential access storage pool, any mount points held by the session will be released.

MAXNUMMP
Specifies the maximum number of mount points a node is allowed to use on the server. This parameter is optional. The default value is 1. You can specify an integer from 0-999. A value of 0 specifies that a node cannot acquire any mount point for a backup or archive operation. However, the server will still allow the node a mount point for a restore or retrieve operation.

Examples

Task 1

Register the client node JOEOS2 with the password SECRETCODE and assign this node to the DOM1 policy domain. This node can delete its own backup and archive files from the server. All files are compressed by the client node before they are sent to the server. This command automatically creates a JOEOS2 administrative user ID with password SECRETCODE. In addition, the administrator now has client owner authority to the JOEOS2 node.

Command:
register node joeos2 secretcode domain=dom1
 archdelete=yes backdelete=yes
 compression=yes

Task2

Register the client node FRAN and prevent an administrative user ID from being automatically defined.

Command:
register node fran xy34z userid=none

Task 3

Grant client owner authority to an existing administrative user ID, HELPADMIN, when registering the client node JAN. This would not automatically create an administrator ID named JAN, but would grant client owner authority for this node to the HELPADMIN administrator.

Command:
register node jan pwdsafe userid=helpadmin

Related Commands

Table 217. Commands Related to REGISTER NODE

Command Description
DEFINE ASSOCIATION Associates clients with a schedule.
DEFINE MACHNODEASSOCIATION Associates a TSM node with a machine.
DELETE FILESPACE Deletes data associated with client's filespaces.
LOCK NODE Prevents a client from accessing the server.
REGISTER ADMIN Defines a new administrator without granting administrative authority.
REMOVE NODE Removes a client from the list of registered nodes for a specific policy domain.
RENAME NODE Changes the name for an existing user that belongs to a specific policy domain.
QUERY NODE Displays partial or complete information about one or more clients.
SET PASSEXP Specifies the number of days after which a password is expired and must be changed.
SET REGISTRATION Specifies whether users can register themselves or must be registered by an administrator.
UNLOCK NODE Enables a locked user in a specific policy domain to access the server.
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 ]