Use this command to register a 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 exists with the same name as the node that is 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.
If
you do not specify an administrator name or select USERID=NONE,
the administrator is given the same name as the node. To keep the
same-named node and administrator synchronized, the authentication
method and the SSLREQUIRED setting for the administrator
are updated to match the node. Passwords that are shared between same-named
nodes and administrators are kept synchronized during an authentication
change.
If you register a node that has the same name as an
administrator, the administrator authentication method and SSLREQUIRED setting
change to match those of the node.
Important: When sslrequired=serveronly in
a REGISTER NODE command, the admin SSLREQUIRED setting
reverts to YES. To use a non-SSL session with a storage agent, rename
the admin with the identical name by issuing the RENAME ADMIN command.
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
(1)
>>-REGister Node--node_name------password----------------------->
.-USerid--=--node_name---.
>--+------------------------+--+------------------------+------->
| (2) | '-USerid--=--+-NONE----+-'
'-------PASSExp--=--days-' '-user_id-'
.-DOmain--=--STANDARD--------.
>--+------------------+--+----------------------------+--------->
'-CONtact--=--text-' '-DOmain--=----domain_name---'
.-COMPression--=--Client-----. .-ARCHDELete--=--Yes-----.
>--+----------------------------+--+------------------------+--->
'-COMPression--=--+-Client-+-' '-ARCHDELete--=--+-Yes-+-'
+-Yes----+ '-No--'
'-No-----'
.-BACKDELete--=--No------.
>--+------------------------+----------------------------------->
'-BACKDELete--=--+-No--+-'
'-Yes-'
>--+------------------------------+----------------------------->
'-CLOptset--=--option_set_name-'
.-FORCEPwreset--=--No------. .-Type--=--Client------.
>--+--------------------------+--+----------------------+------->
'-FORCEPwreset--=--+-No--+-' '-Type--=--+-Client--+-'
'-Yes-' | (3) |
+-NAS-----+
'-Server--'
.-MAXNUMMP--=--1------.
>--+-------------+--+---------------------+--------------------->
'-URL--=--url-' '-MAXNUMMP--=--number-'
.-AUTOFSRename--=--No---------. .-KEEPMP--=--No------.
>--+-----------------------------+--+--------------------+------>
'-AUTOFSRename--=--+-Yes----+-' '-KEEPMP--=--+-No--+-'
+-No-----+ '-Yes-'
'-Client-'
.-VALIdateprotocol--=--No-----------.
>--+-----------------------------------+------------------------>
'-VALIdateprotocol--=--+-No-------+-'
+-Dataonly-+
'-All------'
.-TXNGroupmax--=--0----------.
>--+----------------------------+------------------------------->
'-TXNGroupmax--=--+-0------+-'
'-number-'
.-DATAWritepath--=--ANY---------.
>--+-------------------------------+---------------------------->
'-DATAWritepath--=--+-ANY-----+-'
+-LAN-----+
'-LANFree-'
.-DATAReadpath--=--ANY---------.
>--+------------------------------+----------------------------->
'-DATAReadpath--=--+-ANY-----+-'
+-LAN-----+
'-LANFree-'
>--+-------------------------+---------------------------------->
'-TARGETLevel--=--V.R.M.F-'
.-SESSIONINITiation--=--Clientorserver---------------------------------------------------.
>--+----------------------------------------------------------------------------------------+-->
'-SESSIONINITiation--=--+-Clientorserver-----------------------------------------------+-'
'-SERVEROnly--HLAddress--=--ip_address--LLAddress--=--tcp_port-'
>--+--------------------------------------------------+--------->
'-HLAddress--=--ip_address--LLAddress--=--tcp_port-'
>--+------------------------------+----------------------------->
'-EMAILADdress--=--userID@node-'
.-DEDUPlication--=--SERVEROnly---------.
>--+--------------------------------------+--------------------->
'-DEDUPlication--=--+-SERVEROnly-----+-'
'-Clientorserver-'
.-BACKUPINITiation--=--All----------.
>--+-----------------------------------+------------------------>
| (4) |
'-BACKUPINITiation--=--+-All--+-----'
'-ROOT-'
>--+----------------------------+------------------------------->
'-REPLState--=--+-ENabled--+-'
'-DISabled-'
.-BKREPLRuledefault--=--DEFAULT-----------------------------.
>--+-----------------------------------------------------------+-->
| (5) |
'-------BKREPLRuledefault--=--+-ALL_DATA------------------+-'
+-ACTIVE_DATA---------------+
+-ALL_DATA_HIGH_PRIORITY----+
+-ACTIVE_DATA_HIGH_PRIORITY-+
+-DEFAULT-------------------+
'-NONE----------------------'
.-ARREPLRuledefault--=--DEFAULT--------------------------.
>--+--------------------------------------------------------+--->
| (5) |
'-------ARREPLRuledefault--=--+-ALL_DATA---------------+-'
+-ALL_DATA_HIGH_PRIORITY-+
+-DEFAULT----------------+
'-NONE-------------------'
.-SPREPLRuledefault--=--DEFAULT--------------------------.
>--+--------------------------------------------------------+--->
| (5) |
'-------SPREPLRuledefault--=--+-ALL_DATA---------------+-'
+-ALL_DATA_HIGH_PRIORITY-+
+-DEFAULT----------------+
'-NONE-------------------'
.-ROLEOVERRIDE--=--Usereported-----.
>--+----------------------------------+------------------------->
'-ROLEOVERRIDE--=--+-Client------+-'
+-Server------+
+-Other-------+
'-Usereported-'
(6)
.-------AUTHentication--=--LOcal-.
>--+--------------------------------+--------------------------->
'-AUTHentication--=--+-LOcal-+---'
'-LDap--'
.-SSLrequired--=--DEFault--------.
>--+--------------------------------+--------------------------->
'-SSLrequired--=--+-Yes--------+-'
+-No---------+
+-DEFault----+
'-SERVERonly-'
.-SPLITLARGEObjects--=--Yes-----.
>--+-------------------------------+---------------------------><
'-SPLITLARGEObjects--=--+-Yes-+-'
'-No--'
Notes:
- A password is not required if you register
an administrator and select AUTHENTICATION=LDAP.
At logon, you are prompted for a password.
- The PASSEXP command
does not apply to administrators who authenticate to an LDAP directory
server.
- This parameter is only available for AIX®, HP-UX, Linux, Solaris, and Windows operating systems.
- The BACKUPINITIATION parameter
is ignored if the client node operating system is not supported.
- You can specify the BKREPLRULEDEFAULT, ARREPLRULEDEFAULT,
or SPREPLRULEDEFAULT parameter only if you specify
the REPLSTATE parameter.
- The default value can change if you issued
the SET DEFAULTAUTHENTICATION command and specified
LDAP.
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 password, which has a maximum length
of 64 characters. A password that authenticates with the Tivoli® Storage
Manager server is
considered "LOCAL" and is not case-sensitive. A password that
authenticates with an LDAP directory server is considered "LDAP" and
is case-sensitive. See Naming Tivoli Storage Manager objects for
a table that lists the characters available for specifying a password.
Tip: A password is not required if you register a node and select AUTHENTICATION=LDAP.
At logon, you are prompted for 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 server common-password expiration
period is used. The common password expiration period is 90 days unless
changed by issuing the SET PASSEXP command.
You can change the password expiration period by using
the UPDATE NODE or SET PASSEXP commands.
You can issue the SET PASSEXP command to set a
common expiration period for all administrators and client nodes.
You can also use the command to selectively set password expiration
periods. If you selectively set a password expiration period by using
the REGISTER NODE command, the UPDATE
NODE command, or the SET PASSEXP command,
the expiration period is excluded from common password expiration
periods that were created by using the SET PASSEXP command.
You
can use the RESET PASSEXP command to reset the
password expiration period to the common expiration period. The PASSEXP command
does not apply to nodes that authenticate to an LDAP directory server.
- 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 by using the node name 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. You can specify
one of the following values:
- NONE
- Specifies that an administrative user ID is not automatically
defined.
- user_id
- Specifies a node ID different from the node that
is 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 that identifies
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 that is 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.
Note: This parameter does not
apply to nodes with a type of NAS or SERVER.
You can specify
one of the following values:
- 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.
You can specify one of the following values:
- 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.
You can specify one of the following values:
- 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. You can specify
one of the following values:
- 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 log on to the server.
- Yes
- Specifies that the client node password expires at the next logon.
The client must change or reset the password then. If a password is
not specified, you receive an error message.
- Type
- Specifies the type of node that is being registered.
The parameter is optional. The default value is CLIENT. You can specify
one of the following values:
- Client
- Specifies that the client node is a Backup-Archive Client, Tivoli Storage
Manager for Space Management client,
or application client.
- NAS
- Specifies that the node is a network-attached storage (NAS) file
server whose data is protected by using NDMP operations. The node
name cannot be SERVER.
Note: The name of the NAS node
must be the same as the data mover. Therefore, the name cannot be
changed after a corresponding data mover is defined.
- Server
- Specifies that the client node is a source server that is being
registered on the target server.
- URL
- Specifies the URL address that is used in your
web browser to administer the client node. The parameter is optional.
The URL address can be used to open the web client from the Operations Center. The URL must
be formatted as a standard web address, and must include the client
DNS name or IP address and the port number for the web client, separated
by a colon.
- MAXNUMMP
- Specifies the maximum number of mount points a node is allowed
to use on the server or storage agent only for operations such as
backup, archive, and Tivoli Storage
Manager for Space Management migration.
The parameter is optional and does not apply to nodes with a type
of NAS or SERVER. 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 client data store operation. The MAXNUMMP value
is not evaluated or enforced during client data read operations such
as restore, retrieve, and Tivoli Storage
Manager for Space Management recall.
However, mount points in use for data read operations are evaluated
against attempted concurrent data store operations for the same client
node and might prevent the data store operations from being able to
acquire mount points.
For volumes in a storage pool that is associated
with the FILE or CENTERA device type, the server can have multiple
sessions to read and one process to write to the same volume concurrently.
To increase concurrency and provide efficient access for nodes with
data in FILE or CENTERA storage pools, increase the value of the MAXNUMMP parameter.
For
nodes that store data into primary storage pools with the simultaneous-write
function enabled, you must adjust the value of the MAXNUMMP parameter
to specify the correct number of mount points for each client session.
A client session requires one mount point for the primary storage
pool and one mount point for each copy storage pool and each active-data
pool.
For server-to-server backup, if one server is at a different
version than the other server, set the number of mount points on the
target server to a value higher than 1. Otherwise, you receive an
error.
A storage agent independently tracks the
number of points that are used during a client session. If a node
has a storage agent that is installed, it might exceed the MAXNUMMP
value. The MAXNUMMP value might also be exceeded under conditions
where the node does not have to wait for a mount point.
Note: The
server might preempt a client operation for a higher priority operation
and the client might lose a mount point if no other mount points are
available. See the Administrator's Guide for
more information.
- KEEPMP
- Specifies whether the client node keeps the mount point for the
entire session. The parameter is optional. The default value is NO.
You can specify one of the following values:
- 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 releases 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.
- AUTOFSRename
- Specify whether file spaces are automatically renamed
when you upgrade the client system to support Unicode or specify whether
file spaces are renamed by the client, if needed. The default is NO.
Setting the parameter to YES enables automatic renaming, which occurs
when the client runs one of the following operations: archive, selective
backup, full incremental backup, or partial incremental backup. The
automatic 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 Tivoli Storage
Manager clients
by using Windows, Macintosh
OS X, and NetWare operating systems.
After the client with support
for Unicode is installed, any new file spaces that the client backs
up are stored in server storage by using the UTF-8 code page. UTF-8
is a byte-oriented encoding form that is specified by the Unicode
Standard.
You can specify one of the following values:
- Yes
- Existing file spaces are automatically renamed when you upgrade
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 a format that is not Unicode.
- No
- Existing file spaces are not automatically renamed 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 Clients Installation and
User's Guide book
for more information about the client option.
- VALIdateprotocol
- Specify whether Tivoli Storage
Manager performs
a cyclic redundancy check (CRC) to validate the data that is sent
between the client and server. The parameter is optional. The default
is NO. You can specify one of the following values:
- No
- Specifies that data validation is not performed on any data that
is sent between the client and server.
- Dataonly
- Specifies that data validation is performed only on file data
that is sent between the client and server. This does not include
the file metadata. This mode impacts performance because extra overhead
is required to calculate and compare CRC values between the client
and the server.
- All
- Specifies that data validation is performed on all client file
data, client file metadata, and Tivoli Storage
Manager server metadata
that is sent between the client and server. This mode impacts performance
as extra overhead is required to calculate and compare CRC values
between the client and the server.
- TXNGroupmax
Specifies the number of files per transaction
commit that are transferred between a client and a server. Client
performance might be improved by using a larger value for this option.
The default value is 0. Specifying 0 indicates the
node uses the server global value that is set in the server options
file. To use a value other than the server global value, specify a
value of 4 through 65,000 for this parameter. The node value takes
precedence over the server value.
Attention: Increasing the TXNGROUPMAX value increases the recovery
log utilization. Higher recovery log utilization might increase the
risk of running out of log space. Evaluate the performance of each
node before you change the parameter. For more information about managing
the recovery log, see the Administrator's Guide.
- DATAWritepath
- Specifies the transfer path that is used when the
client sends data to the server, storage agent, or both, during storage
operations such as backup or archive. The parameter is optional. The
default is ANY.
Note: If a path is unavailable, the node cannot send
any data. For example, if you select the LAN-free option but a LAN-free
path is not defined, the operation fails.
You can specify
one of the following values:
- ANY
- Specifies that data is sent to the server, storage agent, or both,
by any available path. A LAN-free path is used if one is available.
If a LAN-free path is unavailable, the data is moved by using the
LAN.
- LAN
- Specifies that data is sent by using the LAN.
- LANFree
- Specifies that data is sent by using a LAN-free path.
- DATAReadpath
- Specifies the transfer path that is used when the
server, storage agent, or both read data for a client, during operations
such as restore or retrieve. The parameter is optional. The default
is ANY.
Note: If a path is unavailable, data cannot
be read. For example, if you select the LAN-free option but a LAN-free
path is not defined, the operation fails. The value for the transfer
path also applies to failover connections. If the value is set to LANFree,
failover cannot occur for the node on the secondary server.
You can specify one of the following values:
- ANY
- Specifies that the server, storage agent, or both use any available
path to read data. A LAN-free path is used if one is available. If
a LAN-free path is unavailable, the data is read by using the LAN.
- LAN
- Specifies that data is read by using the LAN.
- LANFree
- Specifies that data is read by using a LAN-free path.
- TARGETLevel
Specifies the client deployment package that
is targeted for this node. You can substitute an applicable release
package for Version.Release.Modification.Fix (V.R.M.F) Level. For
example: TARGETLevel=6.2.0.0.
You must specify
each segment with a number that is applicable to a deployment package.
You cannot use an asterisk in any field as a substitution for a valid
number. The parameter is optional.
Restriction: The TARGETLEVEL parameter
does not apply to nodes with a type of NAS or SERVER.
- SESSIONINITiation
Controls whether the server or the client initiates sessions.
The default is that the client initiates sessions. The parameter is
optional.
- Clientorserver
- Specifies that the client might initiate sessions
with the server by communicating on the TCP/IP port that is defined
with the server option TCPPORT. Server-prompted scheduling might also
be used to prompt the client to connect to the server.
- SERVEROnly
- Specifies that the server does not accept client
requests for sessions. All sessions must be initiated by server-prompted
scheduling on the port that is defined for the client with the REGISTER or UPDATE
NODE commands. You cannot use the client acceptor, dsmcad,
to start the scheduler when SESSIONINITIATION is set to SERVERONLY.
- HLAddress
Specifies the client IP address that the server
contacts to initiate scheduled events. This parameter must be used
when SESSIONINITIATION is set to SERVERONLY, regardless of any addresses
that are previously used by the client to contact the server.
The address can be specified either in numeric or host
name format. If a numeric address is used, it is saved without verification
by a domain name server. If the address is not correct, it can cause
failures when the server attempts to contact the client. Host name
format addresses are verified with a domain name server. Verified
names are saved and resolved with Domain Name Services when the server
contacts the client.
- LLAddress
Specifies the client port number on which the
client listens for sessions from the server. This parameter must be
used when SESSIONINITIATION is set to SERVERONLY, regardless of any
addresses that are previously used by the client to contact the server.
The
value for this parameter must match the value of client option TCPCLIENTPORT.
The default value is 1501.
- EMAILADdress
- This parameter is used for more contact information.
The information that is specified by this parameter is not acted upon
by Tivoli Storage
Manager.
- DEDUPlication
- Specifies where data deduplication can occur for this node. You
can specify one of the following values:
- SERVEROnly
- Specifies that data stored by this node can be deduplicated on
the server only. This value is the default.
- Clientorserver
- Specifies that data stored by this node can be deduplicated on
either the client or the server. For data deduplication to take place
on the client, you must also specify a value of YES for the DEDUPLICATION
client option. You can specify this option in the client option file
or in the client option set on the Tivoli Storage
Manager server.
- BACKUPINITiation
- Specifies whether the non-root user ID on the client node can
back up files to the server. The parameter is optional. The default
value is ALL, indicating that non-root user IDs can back up data to
the server. You can select one of the following values:
- All
- Specifies that non-root user IDs can back up files to the server.
ALL is the default if BACKUPINITIATION is not specified.
- ROOT
- Specifies that the root user ID can back up files to the server.
If you are using the V6.4 or later backup-archive client, authorized
users have the same privileges as the root user ID.
Restriction: The attribute is ignored by the server if the backup-archive
client connects from a platform other than AIX, HP-UX, Linux,
Solaris, or Mac OS.
Remember: The application programming
interface (API) is affected by the BACKUPINITIATION parameter on the
server. By default, all API users are allowed to back up data. Setting
the parameter to ROOT on an API node is not recommended.
- REPLState
- Specifies whether data that belongs to the client node is ready
to be replicated. This parameter is optional. Specify this parameter
only if you are issuing the REGISTER NODE command
on a server that is configured to replicate data to a target replication
server. If you register a client node on a source replication server
and set up replication for the node, do not register the node on the
target replication server. The client node is created automatically
on the target server the first time that replication occurs.
You
can select one of the following values:
- ENabled
- Specifies that the client node is configured for replication and
is ready to replicate. When you specify this parameter, the replication
mode in the client node definition on the source replication server
is automatically set to SEND. This setting indicates that data that
belongs to the client node is sent to a target server during replication.
When
replication first occurs for the client node, the replication state
of the node on the target replication server is automatically set
to ENABLED. The replication mode on the target replication server
is set to RECEIVE. This setting indicates that data that belongs to
the client node is received from a source replication server. To determine
the replication state and mode, issue the QUERY NODE command
on a source or a target replication server.
- DISabled
- Specifies that the node is configured for replication but that
replication does not occur until you enable it.
- BKREPLRuledefault, ARREPLRuledefault,
and SPREPLRuledefault
- Specifies the replication rule that applies to a data type if
the file space rules for the data type are set to DEFAULT.
Restriction: You can
specify the BKREPLRULEDEFAULT, ARREPLRULEDEFAULT,
or SPREPLRULEDEFAULT parameter only if you specify
the REPLSTATE parameter.
- BKREPLRuledefault
- Specifies the replication rule for backup data.
- ARREPLRuledefault
- Specifies the replication rule for archive data.
- SPREPLRuledefault
- Specifies the replication rule for space-managed data.
If the file space rules for the data type are set to
DEFAULT and you do not specify a rule for the BKREPLRULEDEFAULT, ARREPLRULEDEFAULT,
or SPREPLRULEDEFAULT parameter, data is replicated
according to the server rule for the data type.You can specify normal-priority
replication or high-priority replication rules. In a replication process
that includes both normal and high-priority data, high-priority data
is replicated first. Before you specify a rule, consider the order
in which you want the data to be replicated.
You can specify the following rules:
- ALL_DATA
- Replicates active and inactive backup data, archive data, or space-managed
data. The data is replicated with a normal priority.
- ACTIVE_DATA
- Replicates only active backup data. The data is replicated with
a normal priority. This rule is valid only for BKREPLRULEDEFAULT.
Attention: - If you specify ACTIVE_DATA, inactive backup data that belongs
to client nodes is not replicated.
- If the replication rule for backup data in any file spaces that
belong to the client node is DEFAULT, inactive backup data in those
file spaces on the target replication server is deleted.
- ALL_DATA_HIGH_PRIORITY
- Replicates active and inactive backup data, archive data, or space-managed
data. Data is replicated with a high priority.
- ACTIVE_DATA_HIGH_PRIORITY
- Replicates only active backup data. The data is replicated with
a high priority. This rule is valid only for BKREPLRULEDEFAULT.
Attention: - If you specify ACTIVE_DATA_HIGH_PRIORITY, inactive backup data
that belongs to client nodes is not replicated.
- If the replication rule for backup data in any file spaces that
belong to the client node is DEFAULT, inactive backup data in those
file spaces on the target replication server is deleted.
- DEFAULT
- Replicates data according to the server replication rule for backup
data.
For example, suppose that you want to replicate the archive
data in all the file spaces that belongs to a client node. Replication
of the archive data is a high priority. One method to accomplish this
task is to specify ARREPLRULEDEFAULT=DEFAULT.
Ensure that the file space rules for archive data are also set to DEFAULT and
that the server rule for archive data is set to ALL_DATA_HIGH_PRIORITY.
Restriction: If a node is configured for replication, the file
space rules are set to DEFAULT after the node stores
data on the source replication server.
- NONE
- Data of the specified type is not replicated.
For example, if
you do not want to replicate space-managed data that belongs to a
client node, specify SPREPLRULEDEFAULT=NONE
- ROLEOVERRIDE
Specifies whether to override the reported role of the client
for processor value unit (PVU) estimation reporting. The default is
USEREPORTED.
The role reported by the client
is either client-device (for example, a workstation) or server-device
(for example, file/print server, application server, database). By
default, the client reports its role that is based on the client type
and the operating system. All clients initially report their role
as server-device, except for Backup-Archive Clients running Microsoft Windows workstation distributions (Windows Vista) and Macintosh
OS X.
Specify one of the following values:
- Client
- Specifies a client-device.
- Server
- Specifies a server-device.
- Other
- Specifies that this node is not to be used for
PVU estimation reporting. This can be useful when there are multiple
nodes that are deployed for a physical system (for example, virtual
environments, test nodes, retired nodes, and nodes not in production
or clustering).
- Usereported
- Use the reported role that is provided by the client.
- AUTHentication
- This parameter specifies the password authentication method for
the node. Specify one of the following values: LDAP or LOCAL. The
parameter is optional and defaults to LOCAL. The default can change
to LDAP if you use the SET DEFAULTAUTHENTICATION command
and specify LDAP.
- LOcal
- Specifies that the local Tivoli Storage
Manager server database
is used.
- LDap
- Specifies that the node uses an LDAP directory server for password
authentication.
Tip: A password is not required if you
register a node and select AUTHENTICATION=LDAP. At
logon, you are prompted for a password.
- SPLITLARGEObjects
- Specifies whether large objects that are stored by this node are
automatically split into smaller pieces, by the server, to optimize
server processing. Specifying Yes causes the server to split large
objects (over 10 GB) into smaller pieces when stored by a client node.
Specifying No bypasses this process. Specify No only if your primary
concern is maximizing throughput of backups directly to tape. The
default value is Yes.
- SSLrequired
- Specifies whether the node must use Secure Sockets Layer (SSL)
to communicate with the Tivoli Storage
Manager server.
When you authenticate passwords with an LDAP directory server, you
must protect the sessions by using SSL or another network security
method.
- Yes
- SSL is required.
- No
- SSL is not required.
- DEFault
- SSL is required for a node if its password authenticates with
an LDAP directory server. SSL is not required for a node that authenticates
its password with the Tivoli Storage
Manager server (LOCAL).
- SERVERonly
- SSL is required between the backup-archive client and the server.
SSL is not required between the backup-archive client and the storage
agent.
Example: Register a client node that
only the root user can back up
Register the client node
mete0rite with
password
KingK0ng to back up files from only the root
user to the server.
register node mete0rite KingK0ng
backupinit=root
Example: Register a client node and password and set
compression on
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.
register node joeos2 secretcode domain=dom1
archdelete=yes backdelete=yes
compression=yes
Example: Register a client node and password and prevent
the administrative ID from being automatically assigned
Register
the client node
FRAN and prevent an administrative
user ID from being automatically defined
register node fran xy34z userid=none
Example: Grant client owner authority
for an existing administrative user
Grant client owner authority
to an existing administrative user ID,
HELPADMIN, when
you register 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.
register node jan pwdsafe userid=helpadmin
Example: Register a NAS file server node that uses
NDMP operations
Register a node name of
NAS1 for
a NAS file server that is using NDMP operations. Assign this node
to a special NAS domain.
register node nas1 pw4pw domain=nasdom type=nas
Example: Register a node and specify
data validation
Register a node name of
ED whose
data is backed up to a primary storage pool that also has a list of
2 copy storage pools defined. The primary storage pool is of disk
device type, and the 2 copy storage pools are of sequential device
type. Specify 2 as the maximum number of mount points. The client's
network has been unstable during the last few weeks. You must ensure
that the client data is not corrupted when it is sent over the network.
Specify the
VALIDATE PROTOCOL parameter to validate
all data that is sent from the client to the server.
register node ed pw45twx maxnummp=2 validateprotocol=all
Example: Register a node and specify the maximum number
of files per transaction commit
Register a node name of
ED and
set the TXNGroupmax to 1,000.
register node ed pw45twx txngroupmax=1000
Example: Register a node and allow it to deduplicate
data on the client system
Register a node name of
JIM and
allow it to deduplicate data on the client system.
register node jim jim deduplication=clientorserver
Example: Register a node name of ED and set the role
as a server-device for PVU estimation reporting
Register a
node name of
ED and set the role as a server-device
for PVU estimation reporting.
register node ed pw45twx roleoverride=server
Example: Register a node on a source replication server
Define
NODE1 to a source replication server. Specify a replication rule for
the backup data that belongs to NODE1 so that active backup data is
replicated with a high priority. Enable replication for the node.
register node node1 bkreplruledefault=active_data_high_priority replstate=enabled
Example: Register a node that uses a password that
authenticates with an LDAP directory server
Register a node
name of node17 that must authenticate to an LDAP directory server.
register node node17 n0de17n0de#seventeen authentication=ldap
You
must enter a new password the next time you log on if the new password
does not adhere to requirements for a
"complex" password.
Related commands
Table 1. Commands related to REGISTER NODECommand |
Description |
DEFINE ASSOCIATION |
Associates clients with a schedule. |
DEFINE DATAMOVER |
Defines a data mover to the Tivoli Storage Manager server. |
DEFINE MACHNODEASSOCIATION |
Associates a Tivoli Storage Manager node with a machine. |
DELETE FILESPACE |
Deletes data associated with client file spaces.
If a file space is part of a collocation group and you remove the
file space from a node, the file space is removed from the collocation
group. |
LOCK NODE |
Prevents a client from accessing the server. |
QUERY FILESPACE |
Displays information about data in file spaces
that belong to a client. |
QUERY NODE |
Displays partial or complete information about
one or more clients. |
QUERY PVUESTIMATE |
Displays an estimate of the client-devices
and server-devices being managed. |
QUERY REPLNODE |
Displays information about the replication
status of a client node. |
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. |
REMOVE REPLNODE |
Removes a node from replication. |
RENAME NODE |
Changes the name for a client node. |
RESET PASSEXP |
Resets the password expiration for nodes or
administrators. |
SET DEFAULTAUTHENTICATION |
Specifies the default password authentication
method for any REGISTER NODE or REGISTER ADMIN commands. |
SET PASSEXP |
Specifies the number of days after which
a password is expired and must be changed. |
SET CPUINFOREFRESH |
Specifies the number of days between
client scans for workstation information used for PVU estimates. |
SET DEDUPVERIFICATIONLEVEL |
Specifies the percentage of extents verified
by the server during client-side deduplication. |
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 FILESPACE |
Changes file-space node-replication rules. |
UPDATE NODE |
Changes the attributes associated with a client
node. |