Tivoli Header
Administrator's Reference
Use this command to modify the attributes of a registered node.
You must use the RENAME NODE command to change the name of a 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 belongs.
Syntax
(1)
>>-UPDate Node-------node_name---------------------------------->
>--+----------------------------------------+------------------->
+-password--+--------------------------+-+
| '-FORCEPwreset--=--+-No--+-' |
| '-Yes-' |
'-FORCEPwreset--=--Yes-------------------'
>--+------------------+--+------------------------------+------->
'-PASSExp--=--days-' '-CLOptset--=--option_set_name-'
>--+------------------+--+------------------------+------------->
'-CONtact--=--text-' '-DOmain--=--domain_name-'
>--+----------------------------+--+------------------------+--->
'-COMPression--=--+-Client-+-' '-ARCHDELete--=--+-Yes-+-'
+-Yes----+ '-No--'
'-No-----'
>--+------------------------+----------------------------------->
'-BACKDELete--=--+-No--+-'
'-Yes-'
>--+-----------------------------+------------------------------>
'-WHEREDOmain--=--domain_name-'
>--+----------------------------------------+------------------->
'-WHEREPLatform--=--client_platform_name-'
>--+---------------------+--+--------------------+-------------->
'-MAXNUMMP--=--number-' '-KEEPMP--=--+-No--+-'
'-Yes-'
>--+---------------------+--+-----------------------------+----->
'-URL--=--url_address-' '-AUTOFSRename--=--+-Yes----+-'
+-No-----+
'-Client-'
>--+-----------------------------------+-----------------------><
'-VALIdateprotocol--=--+-No-------+-'
+-Dataonly-+
'-All------'
Notes:
- You must specify at least one optional parameter on this command.
Parameters
- node_name (Required)
- Specifies the name of the client node to be updated. You can use
wildcard characters to specify this name.
- password
- Specifies the new password for the client node. This parameter is
optional. The maximum length of the password is 64 characters.
Passwords remain current for a period determined by the password expiration
period.
- FORCEPwreset
- Specifies whether to force a client to change or reset the
password. This parameter is optional. Possible values are:
- No
- Specifies that the password expiration period is set by the SET PASSEXP
command. The administrator does not force a client to change or reset
the password while attempting to logon to the server.
- Note:
- This value is valid only when you specify a password.
- Yes
- Specifies that the client node or administrator's password will expire
at the next logon. The client must change or reset the password at that
time.
- 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 expiration
period is unchanged.
- CLOptset
- Specifies the name of the option set to be used by the client. This
parameter is optional.
- CONtact
- Specifies a text string of information identifying the client node.
This parameter is optional. The maximum length of the text string is
255 characters. Enclose the contact information in quotation marks if
it contains any blanks. To remove previously defined contact
information, specify a null string ("").
- DOmain
- Specifies the name of the policy domain to which the client node is
registered. This parameter is optional.
- COMPression
- Specifies whether the client node compresses its files before sending them
to the server for backup and archive. This parameter is
optional.
Possible values are:
- Client
- Specifies that the client determines whether files will be
compressed.
- 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 archived files from
the server. This parameter is optional. 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. This parameter is optional. 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.
- WHEREDOmain
- Specifies the name of the policy domain to be used as a filter in
combination with the node name to select nodes to update. This
parameter is optional.
- WHEREPLatform
- Specifies the name of the client platform to be used as a filter in
combination with the node name to select nodes to update. This
parameter is optional.
- MAXNUMMP
- Specifies the maximum number of mount points a node is allowed to use on
the server. 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. If the client stores its data to a storage pool that has copy
storage pools defined for simultaneous backup, the client may require
additional mount points. As a general rule, you must assign one mount
point for each copy storage pool of sequential device type. If the
primary storage pool is of sequential device type, then assign a mount point
for the primary storage pool as well.
- URL
- Specifies the client's Uniform Resource Locator (URL) address that
the administrator can use to administer the Tivoli Storage Manager
client. If you want to remove the value for this field, specify empty
single quotes or empty double quotes with no spaces, '' or
"".
- KEEPMP
- Specifies whether the client node keeps the mount point for the entire
session. The parameter is optional. Possible values are:
- 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.
- 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.
- AUTOFSRename
- Specifies whether the client is prompted for renaming file spaces when the
client system upgrades to a client that supports Unicode. The prompting
and renaming, if allowed, occur only when the client runs one of the following
operations: archive, selective backup, full incremental backup, or
partial incremental backup. The renaming changes the names of existing
backed-up file spaces that are not in Unicode in server storage. Then
the file spaces are backed up in Unicode. You can use this parameter
for Unicode-enabled TSM clients using Windows NT and Windows 2000 operating
systems.
- Note:
- After the client with support for Unicode is installed, any new file spaces
that the client backs up are stored in server storage using the UTF-8 code
page. UTF-8 is a byte-oriented encoding form specified by the Unicode
Standard.
Possible values are:
- Yes
- The server automatically renames existing file spaces when the client
system upgrades to a client that supports Unicode, and the client runs one of
the following operations: archive, selective backup, full incremental
backup, or partial incremental backup. The renaming occurs whether the
client uses the graphical user interface, the command line, or the client
scheduler.
For example, the server renames a drive as follows:
Original name: D_DRIVE
New name: D_DRIVE_OLD
The new name indicates that the file space is stored on the server in
format that is not Unicode.
- No
- The server does not rename file spaces automatically when the client
system upgrades to a client that supports Unicode, and the client runs one of
the following operations: archive, selective backup, full incremental
backup, or partial incremental backup.
- Client
- The option AUTOFSRENAME in the client's option file determines
whether file spaces are renamed.
By default, the client option is set to PROMPT. When the client
system upgrades to a client that supports Unicode and the client runs a Tivoli
Storage Manager operation with the graphical user interface or the command
line, the program displays a one-time prompt to the user about whether to
rename file spaces.
When the client scheduler runs an operation, the program does not prompt
for a choice about renaming, and does not rename file spaces. Backups
of existing file spaces are sent as before (not in Unicode).
Refer to the appropriate Backup-Archive Installation and User's
Guide book for more information on the client option.
- VALIdateprotocol
- Specify whether Tivoli Storage Manager performs a cyclic redundancy check
to validate the data sent between the client and the server. The
parameter is optional. Possible values are:
- No
- Specifies that Tivoli Storage Manager not perform data validation on any
data sent between the client and server.
- Dataonly
- Specifies that Tivoli Storage Manager perform data validation only on file
data that is sent between the client and server. This does not include
the file metadata. This mode impacts performance as additional overhead
is required to calculate and compare cyclic redundancy check (CRC) values
between the client and the server.
- All
- Specifies that Tivoli Storage Manager perform data validation on all
client file data, client file metadata, and server metadata that is sent
between the client and server. This mode impacts performance as
additional overhead is required to calculate and compare CRC values between
the client and the server.
Examples
Task
Update node LARRY so that the data on node LARRY will be compressed when it
is backed up or archived by Tivoli Storage Manager and so that the client
cannot delete archived files.
- Command:
- update node larry compression=yes archdelete=no
Related Commands
Table 270. Commands Related to UPDATE NODE
Command
| Description
|
QUERY NODE
| Displays partial or complete information about one or more
clients.
|
REGISTER ADMIN
| Defines a new administrator without granting administrative
authority.
|
REGISTER NODE
| Defines a client to the server and sets options for that user.
|
REMOVE NODE
| Removes a client from the list of registered nodes for a specific policy
domain.
|
RENAME NODE
| Changes the name for a user that belongs to a specific policy
domain.
|
SET PASSEXP
| Specifies the number of days after which a password is expired and must
be changed.
|
UPDATE ADMIN
| Changes the password or contact information associated with any
administrator.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]