Tivoli Storage Manager for Sun Solaris Administrator's Reference

UPDATE SERVER (Update a Server Defined for Server-to-Server Communications)

Use this command to update a server definition.

Privilege Class

To issue this command, you must have system privilege.

Syntax

For Enterprise Configuration, Enterprise Event Logging, Command Routing, and Storage Agent:

>>-UPDate--SERver--server_name---------------------------------->
 
>-----+------------------------------+-------------------------->
      '-SERVERPAssword--=--password--'
 
>-----+---------------------------+----------------------------->
      '-HLAddress--=--ip_address--'
 
>-----+-------------------------+---+-----------------------+--->
      '-LLAddress--=--tcp_port--'   '-COMMmethod--=--TCPIP--'
 
>-----+--------------+---+---------------------------+---------->
      '-URL--=--url--'   '-ALLOWReplace--=--+-Yes-+--'
                                            '-No--'
 
>-----+------------------------------+-------------------------->
      '-DESCription--=--description--'
 
>-----+---------------------------------+----------------------><
      |  (1)                            |
      '--------CROSSDefine--=--+-No--+--'
                               '-Yes-'
 

Notes:

  1. The CROSSDEFINE parameter does not apply to storage agent definitions.

For Virtual Volumes

>>-UPDate--SERver--server_name----+------------------------+---->
                                  '-PAssword--=--password--'
 
>-----+---------------------------+----------------------------->
      '-HLAddress--=--ip_address--'
 
>-----+-------------------------+---+-----------------------+--->
      '-LLAddress--=--tcp_port--'   '-COMMmethod--=--TCPIP--'
 
>-----+--------------+---+--------------------------+----------->
      '-URL--=--url--'   '-DELgraceperiod--=--days--'
 
>-----+-------------------------+---+------------------------+-->
      '-NODEName--=--node_name--'   '-FORCESync--=--+-Yes-+--'
                                                    '-No--'
 
>-----+------------------------------+-------------------------><
      '-DESCription--=--description--'
 

Parameters

server_name (Required)
Specifies the name of the server to be updated. This parameter is required.

PAssword
Specifies the password used to sign on to the target server for virtual volumes. This parameter is optional.

SERVERPAssword
Specifies the server password, which is used for enterprise configuration, command routing, and server-to-server event logging functions. The password must match the server password set by the SET SERVERPASSWORD command. This parameter is optional.

HLAddress
Specifies the IP address (in dotted decimal format) of the server. This parameter is optional.

LLAddress
Specifies the low-level address of the server. This address is usually the same as that in the TCPPORT server option of the target server. This parameter is optional.

COMMmethod
Specifies the communication method used to connect to the server. This parameter is optional.

URL
Specifies the URL address used to access this server from a Web administrative interface. The parameter is optional.

DELgraceperiod
Specifies a number of days that an object remains on the target server after it has been marked for deletion. The minimum value is 0. The maximum value is unlimited. This parameter is optional.

NODEName
Specifies a node name to be used by the server to connect to the target server. This parameter is optional.

DESCription
Specifies a description of the server. This parameter is optional. The description can be up to 255 characters. Enclose the description in quotation marks if it contains blank characters. To remove an existing description, specify a null string ('').

CROSSDEFine
Specifies whether the server running this command will define itself to the server being specified by this command. This parameter is optional.
Note:This parameter does not apply to storage agent definitions.
If this parameter is included, you must also issue the SET SERVERNAME, SET SERVERPASSWORD, SET SERVERHLADDRESS, SET CROSSDEFINE, and SET SERVERLLADDRESS commands. The default is NO. Possible values are:

No
Cross definition is not to be performed.

Yes
Cross definition is to be performed.

FORCESync
Specifies whether to reset the server verification key when the source server next signs on to the target server. A valid verification key lets a source server put objects on the target server, manage the grace deletion period value, and update the password (if the current password is known and the verification key matches). The parameter is optional. Possible values are:

Yes
Specifies that a new verification key will be sent to and accepted by the target server if a valid password is received.

No
Specifies that a new verification key will not be sent to the target server.

ALLOWReplace
Specifies whether a server definition that was defined by a managed server can be replaced with a definition from the configuration manager. This parameter is optional. Possible values are:

Yes
Specifies that a server definition can be replaced by a definition from the configuration manager.

No
Specifies that a server definition cannot be replaced by the definition from the configuration manager.

Examples

Task 1

Update the definition of SERVER2 to specify that objects remain on the target server for 10 days after they have been marked for deletion.

Command:
update server server2 delgraceperiod=10

Task 2

Update the definition of NEWSERVER to specify its URL address to be http://newserver:1580/.

Command:
update server newserver url=http://newserver:1580/

Related Commands

Table 315. Commands Related to UPDATE SERVER

Command Description
DEFINE DEVCLASS Defines a device class.
DEFINE SERVER Defines a server for server-to-server communications.
DELETE DEVCLASS Deletes a device class name.
DELETE FILESPACE Deletes data associated with client's filespaces.
DELETE SERVER Deletes the definition of a server.
QUERY NODE Displays partial or complete information about one or more clients.
QUERY SERVER Displays information about servers.
RECONCILE VOLUMES Reconciles source server virtual volume definitions and target server archive objects.
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.
UPDATE DEVCLASS Changes the attributes of a device class.
UPDATE NODE Changes the attributes associated with a client node.


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