Repltcpserveraddress

The repltcpserveraddress option specifies the TCP/IP address of the secondary server to be used when the client connects to the secondary server during a failover.

This option must be specified within a replservername stanza in the client options file. The replservername stanza contains connection information about the secondary server.

This option is set by the IBM Spectrum Protect™ server administrator for the client node. During the normal (non-failover) logon process, the option is sent to the client and is saved in the client options file.

Do not edit this option during normal operations.

Edit this option only during situations such as the following ones:

The primary server is offline and the information for the secondary server is not in the options file.
The secondary server information is out-of-date or incorrect.

Any values that you edit are removed or updated the next time you log in to the primary server.

Supported Clients

This option is valid for all clients.

Options File

AIX operating systems Linux operating systems Oracle Solaris operating systems Mac OS X operating systems This option is placed in the dsm.sys file within the replservername stanza.

Windows operating systems Place this option in the client options file (dsm.opt).

Syntax


>>-REPLTCPServeraddress----server_address----------------------><

Parameters

server_address: Specifies a TCP/IP address for a server that is 1 - 64 characters in length. Specify a TCP/IP domain name or a numeric IP address. The numeric IP address can be either a TCP/IP v4 or TCP/IP v6 address. You can use only IPv6 addresses if you specified the commmethod V6Tcpip option.

Examples

Options file:

REPLTCPServeraddress dsmchost.example.com

Command line:

Does not apply.

Options file:

The following example demonstrates how to specify options for three different servers in the dsm.sys file, and how to reference the secondary server. Connection information for multiple secondary server is presented in stanzas. Each stanza is identified by the replservername option and the name of the secondary server. The servername stanza must contain the myreplicationserver option, which points to the secondary server that is specified by the replservername stanza. Only one secondary server can be specified per servername stanza.

  REPLSERVERNAME   TargetReplicationServer1
    REPLTCPSERVERADDRESS TargetReplicationServer1 
    REPLTCPPORT          1505
    REPLSSLPORT          1506
    REPLSERVERGUID       91.0f.ef.90.5c.cc.11.e1.ae.34.08.00.00.00.00.00  

  REPLSERVERNAME   TargetReplicationServer2
    REPLTCPSERVERADDRESS TargetReplicationServer2
    REPLTCPPORT          1505
    REPLSSLPORT          1506
    REPLSERVERGUID       91.0f.ef.90.5c.cc.11.e1.ae.34.08.00.00.00.00.02  
 
  SErvername     server_a 
    COMMMethod                TCPip
    TCPPort                   1500 
    TCPServeraddress          server_hostname1.example.com
    PASSWORDAccess            prompt
    MYREPLICATIONServer       TargetReplicationServer1
 
  SErvername     server_b
    COMMMethod                TCPip
    TCPPort                   1500 
    TCPServeraddress          server_hostname2.example.com
    PASSWORDAccess            generate 
    INCLExcl                  /adm/tsm/archive.excl 
    MYREPLICATIONServer       TargetReplicationServer2

  SErvername     server_c
    COMMMethod                TCPip 
    TCPPort                   1500 
    TCPServeraddress          server_hostname3.example.com 
    PASSWORDAccess            generate
    MYREPLICATIONServer       TargetReplicationServer1

Options file:

The following example demonstrates how to specify options for the secondary server in the dsm.opt file, and how to reference the secondary server. The connection information for the secondary server is located within the REPLSERVERName stanza. The MYREPLICATIONServer option points to the secondary server name that is specified by the REPLSERVERName stanza.

REPLSERVERNAME     TargetReplicationServer1
    REPLTCPSERVERADDRESS TargetReplicationServer1
    REPLTCPPORT          1505
    REPLSSLPORT          1506
    REPLSERVERGUID       91.0f.ef.90.5c.cc.11.e1.ae.34.08.00.00.00.00.00 

COMMMethod                TCPip 
TCPPort                   1500
TCPServeraddress          server_hostname1.example.com
PASSWORDAccess            prompt 
MYREPLICATIONServer       TargetReplicationServer1
MYPRIMARYSERVER           Server1