Myreplicationserver

The myreplicationserver option specifies which failover server stanza that the client uses during a failover. Multiple failover server stanzas can be specified.

A failover server stanza is identified by the replservername option and contains connection information about a failover 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 a failover server is not in the options file.
The failover server information is out-of-date or incorrect.

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

Supported Clients

This option is valid for all clients.

Options File

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

Windows operating systems This option is placed in the client options file (dsm.opt).

Syntax

Parameters

repl_servername: Specifies the name of the stanza for each failover server to be used during a failover. This value is usually the name of the failover server, not the host name of the server. Also, the value of the repl_servername parameter is not case-sensitive, but the value must match the value that is specified for the REPLSERVERName option. You can specify up to two failover server stanza names separated by commas.

Examples

Options file:

MYREPLICATIONServer TargetReplicationServer1,TargetReplicationServer2

Command line:

Does not apply.

Options file:

The following example demonstrates how to specify options for multiple failover servers servers in the dsm.sys file, and how to reference the failover servers.

Connection information for multiple failover servers is presented in stanzas. Each stanza is identified by the replservername option and the name of a failover server.

The servername stanza must contain the myreplicationserver option, which points to up to two failover servers that are specified by replservername stanzas.

  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,TargetReplicationServer2

Options file:

The following example demonstrates how to specify options for multiple failover servers in the dsm.opt file, and how to reference the failover servers.

The connection information for each failover server is located within a REPLSERVERName stanza.

The MYREPLICATIONServer option points to up to two failover server names that are specified by the REPLSERVERName stanzas.

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

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