Administrator's Reference

DEFINE SERVER (Define a Server)

Use this command to define a server for the following functions:

Privilege Class

To issue this command, you must have system privilege.

Syntax

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

>>-DEFine--SERver--server_name----SERVERPAssword--=--password--->
 
>----HLAddress--=--ip_address---LLAddress--=--tcp_port---------->
 
>-----+-----------------------+---+--------------+-------------->
      '-COMMmethod--=--TCPIP--'   '-URL--=--url--'
 
>-----+------------------------------+-------------------------->
      '-DESCription--=--description--'
 
      .-CROSSDefine--=--No------.
>-----+-------------------------+------------------------------><
      '-CROSSDefine--=--+-No--+-'
                        '-Yes-'
 

Syntax

For Virtual Volumes:

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

Parameters

server_name (Required)
Specifies the name of the server. This name must be unique on the server. The maximum length of this name is 64 characters.

For command routing and server-to-server event logging functions, the server name you specify here should match the name that was set using the SET SERVERNAME command at the target server.

PAssword
Specifies the password used to sign on to the target server for virtual volumes. If you specify the NODENAME parameter, you must specify the PASSWORD parameter. If you specify the PASSWORD parameter but not the NODENAME parameter, the node name defaults to the server name specified with the SET SERVERNAME command.

SERVERPAssword
Specifies the password of the server you are defining. This password must match the password set by the SET SERVERPASSWORD command. This parameter is required for enterprise configuration, command routing, and server-to-server event logging functions.

HLAddress (Required)
Specifies the IP address (in dotted decimal format) of the server.

LLAddress (Required)
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.

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

URL
Specifies the URL address of this server. 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 default is 5. 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. If you specify the NODENAME parameter, you must also specify the PASSWORD parameter. If you specify the PASSWORD parameter but not the NODENAME parameter, the node name defaults to the server name specified with the SET SERVERNAME command.

DESCription
Specifies a description of the server. The parameter is optional. The description can be up to 255 characters. Enclose the description in quotation marks if it contains blank characters.

CROSSDefine
Specifies whether the server running this command will define itself to the server being specified on the DEFINE SERVER command. This parameter is optional. 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.

Examples

Task 1

A target server has a high-level address of 9.116.2.67 and a low-level address of 1570. Define that target server to the source server, name it SERVER2, set the password to SECRET, and specify that objects remain on the target server for 7 days after they have been marked for deletion.

Command:
define server server2 password=secret hladdress=9.115.3.45 lladdress=1570 delgraceperiod=7

Task 2

Define a server to enable it to receive commands routed from other servers. Name the server WEST_COMPLEX, set the password to CACTUS, and set the high-level address to 9.283.299 and a low-level address to 1500.

Command:
define server west_complex serverpassword=cactus hladdress=9.283.299 lladdress=1500

Task 3

Use cross definition to define SERVER_A and SERVER_B.

Command:

  1. On SERVER_B, specify the server name, password, and high- and low-level addresses of SERVER_B. Specify that cross defining is allowed.
    set servername server_b
    set serverpassword mylife
    set serverhladdress 9.115.20.80
    set serverlladdress 1860
    set crossdefine on
    

  2. On SERVER_A, specify the server name, password, and high- and low-level addresses of SERVER_A.
    set servername server_a
    set serverpassword yourlife
    set serverhladdress 9.115.20.97
    set serverlladdress 1500
    

  3. On SERVER_A, define SERVER_B:
    define server server_b hladdress=9.115.20.80 lladdress=1860
    serverpassword=mylife crossdefine=yes
    

Related Commands

Table 76. Commands Related to DEFINE SERVER

Command Description
DEFINE DEVCLASS Defines a device class.
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.
SET CROSSDEFINE Specifies whether to cross define servers.
SET SERVERNAME Specifies the name by which the server is identified.
SET SERVERHLADDRESS Specifies the high-level address of a server.
SET SERVERLLADDRESS Specifies the low-level address of a server.
SET SERVERPASSWORD Specifies the server password.
SET SERVERURL Specifies the URL used to access a server from a web browser interface.
UPDATE DEVCLASS Changes the attributes of a device class.
UPDATE NODE Changes the attributes associated with a client node.
UPDATE SERVER Updates information about a server.


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