QUERY REPLSERVER (Query a replication server)

Use this command to view information about all replication servers that are known server. The output from this command includes server information for the server from which the command was issued. The command indicates whether a replication server definition is deleted as a result of a REMOVE REPLSERVER command.

Privilege class

Any administrator can issue this command.

Syntax

Parameters

server_name: Specifies the name of the replication server to be queried. You can use wildcard characters to specify this name. All matching servers are queried. If you do not specify a value for this parameter, all servers are queried. The parameter is optional.

Example: Display summary statistics about all replicating servers

Display information about the replicating server. Issue the command from either the source or the target replication server:

query replserver *

Replication Globally Unique ID: 4d.83.fc.30.67.c1.11.e1.b8.
                                      40.f0.de.f1.5e.f1.89
                   Server Name: Server1
             Storage Rule Name: RULEREPL1,REPL1
              Last Replication: 
                     Heartbeat: 
   Failover High Level Address: server1.example.com
      Failover TCP Port Number: 1500
      Failover SSL Port Number: 1542
          Deletion in Progress: No
           Dissimilar Policies:   
                            
Replication Globally Unique ID: 91.0f.ef.90.5c.cc.11.e1.ae.
                                34.08.00.27.00.58.dc
                   Server Name: DRServer1
              Last Replication: 06/30/2012 08:16:30 PM
                     Heartbeat: 07/09/2012 22:15:22 PM
   Failover High Level Address: drserver1.example.com
      Failover TCP Port Number: 1500
      Failover SSL Port Number: 1542
          Deletion in Progress: No
           Dissimilar Policies: On   

Replication Globally Unique ID: 90.4f.53.b0.8e.cb.11.e3.a8.
                                2f.00.14.5e.55.b3.67
                   Server Name: DRSERVER2
              Last Replication: 04/01/14 12:38:28
                     Heartbeat: 05/29/14 11:15:44
   Failover High Level Address: drserver2.example.com
      Failover TCP Port Number: 1500
      Failover SSL Port Number:
          Deletion in Progress: No
           Dissimilar Policies: Off

Example: Display summary statistics about a specific replicating server

Display information about the replicating server DRSERVER1. Issue the command from either the source or the target replication server:

query replserver drserver1

Replication Globally Unique ID: 91.0f.ef.90.5c.cc.11.e1.ae.
                                      34.08.00.27.00.58.dc
                   Server Name: DRServer1
             Storage Rule Name: REPL1
              Last Replication: 06/30/2012 08:16:30 PM
                     Heartbeat: 07/09/2012 22:15:22 PM
   Failover High Level Address: drserver1.example.com
      Failover TCP Port Number: 1500
      Failover SSL Port Number: 1542
          Deletion in Progress: No
           Dissimilar Policies: On

Field descriptions

Replication Globally Unique ID

The unique identifier for the IBM Spectrum® Protect server. The values for the Replication Globally Unique ID are created when a server is first used in a replication process.

Tip: The ID listed in the Replication Globally Unique ID field is not the same value as the value for the ID listed in the Machine Globally Unique ID field that is shown in the QUERY STATUS command.

Server Name

The name of the replication server.

Storage Rule Name

Names of any replication storage rules that are configured to the queried server.

Last Replication

The date of the last replication process that used the server.

Heartbeat

The last time that the server completed a successful test communication session.

Failover High Level Address

The high-level address that the client uses to connect to the replication server during failover.

Failover TCP Port Number

The active Transmission Control Protocol (TCP) client port on the replication server that is used for client connections. If the client is configured for TCP, the port is used to connect to the failover server.

Failover SSL Port Number

The active Secure Sockets Layer (SSL) port on the replication server that is used for client connections. If the client is configured for SSL, the port is used to connect to the failover server.

Deletion in Progress

Specifies whether a REMOVE REPLSERVER command was issued for this replication server and is still in progress. The following values are possible:

Yes: The deletion of the replication server is in progress.
No: The deletion of the replication server is not in progress.

Dissimilar Policies

Specifies whether the policies that are defined on the target replication server are enabled. The following values are possible:

On: The policies on the target replication server manage replicated client-node data.
Off: The policies on the source replication server manage replicated client-node data.

Related commands

Table 1. Commands related to QUERY REPLSERVER
Command	Description
REMOVE REPLNODE (Remove a client node from replication)	Removes a node from replication.
REMOVE REPLSERVER (Remove a replication server)	Removes a server from replication.