Replserverguid
The replserverguid option specifies the globally unique identifier (GUID) that is used when the client connects to the secondary server during failover. The GUID is used to validate the secondary server to ensure that it is the expected server.
The replication GUID is different from the machine GUID of the server. It is generated one time for a server that is doing the replication and never changes.
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 Tivoli® Storage Manager 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.
- 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.
Supported Clients
This option is valid for all clients.
Options File
This option is placed in the dsm.sys file within the replservername stanza.
This option is placed in the client options file (dsm.opt).
Parameters
- serverguid
- Specifies the GUID of the secondary server that is used during a failover.
Examples
- Options file:
- REPLSERVERGUID 91.0f.ef.90.5c.cc.11.e1.ae.34.08.00.00.00.00.02
- 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