Administrator's Reference
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 for 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 191. 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 ]