QUERY REPLFAILURES (Query data about replication failures)

Use this command to display a list of client nodes that failed to replicate. Issue this command on the server that acts as a source for replicated data.

When you issue this command, the output displays a list of files that failed to replicate from the source replication server to a target replication server.

Privilege class

To issue this command, you must have system privilege.

Syntax

Parameters

node_name or node_group_name: Specifies the name of the client node or defined group of client nodes that you want to query. This parameter is optional. You can also specify a combination of client node names and client-node group names. To specify multiple client node names or client-node group names, separate the names with commas with no intervening spaces. You can use wildcard characters (*) with client node names but not with client-node group names.

server_name: Specifies the name of the server that you want to query. You can use wildcard characters to specify the name. All matching servers are queried. This parameter is optional.

Type

Specifies the output format. This parameter is optional. The default value is SUMMARY. You can specify one of the following values:

Summary: Specifies that summarized status is displayed.
Objects: Specifies that a full report is displayed of all objects that failed to replicate.

Example: Display a summary about a specific replication failure

Display a summary about the NODE2 replication failure. See Field descriptions for field descriptions.

query replfailures node2

                    
                          Node Name: NODE2
                               FSID: 1 
                        Server Name: TARGET-1
                          Source RC: 3024
              Source RC Explanation: The bitfile is damaged
                          Target RC: 1062
              Target RC Explanation: The replication transaction is not being processed
                       Object Count: 3

Example: Display a summary about replication failures for several nodes

Display a summary about replication failures for all nodes that are configured to the Target-2 server. See Field descriptions for field descriptions.

query replfailures * target-2

                    
                          Node Name: CLIENT1
                               FSID: 1
                        Server Name: TARGET-2
                          Source RC: 0
              Source RC Explanation: No errors are detected on the current server. Review the 
                                     return code on the other server in the replication pair.
                          Target RC: 2110
              Target RC Explanation: Failure to resolve chunk.
                       Object Count: 41

Example: Display details about all replication failures

Display detailed information about all replication failures on NODE2. See Field descriptions for field descriptions.

query replfailures node2 type=objects

    
          Object Name: \PROJECTS\A.txt
            Object ID: 256004
           Time Stamp: 04/16/2018 14:50:36
            Node Name: NODE2
                 FSID: 1
          Server Name: TARGET-1
            Source RC: 3224
Source RC Explanation: The bitfile is damaged
            Target RC: 1062
Target RC Explanation: The replication transaction is not being processed

          Object Name: \PROJECTS\B.txt
            Object ID: 256005
           Time Stamp: 04/16/2018 14:50:36
            Node Name: NODE2
                 FSID: 1
          Server Name: TARGET-1
            Source RC: 3224
Source RC Explanation: The bitfile is damaged
            Target RC: 3014
Target RC Explanation: An unknown error occurred during an attempt to store a              
                       file on the target replication server. The possible cause 
                       is a failed write operation to disk storage

Field descriptions

Object Name: The name of the object that failed to replicate.
Object ID: The object identifier.
Time Stamp: The date and time when the object starts to be replicated.
Node Name: The name of the client node whose data is displayed.
FSID: The filespace identifier (FSID).
Server Name: The name of the server.
Source RC: The error code.
Source RC Explanation: The reason why the node on the source replication server was not replicated.
Target RC: The error code.
Target RC Explanation: The reason why the target replication server was unable to store data for the node.

Related commands

Table 1. Commands related to QUERY REPLFAILURES
Command	Description
CANCEL PROCESS	Cancels a background server process.
CANCEL REPLICATION	Cancels node replication processes.
QUERY FILESPACE	Displays information about data in file spaces that belong to a client.
QUERY NODE	Displays partial or complete information about one or more clients.
QUERY REPLICATION	Displays information about node replication processes.
QUERY REPLNODE	Displays information about the replication status of a client node.
QUERY REPLRULE	Displays information about node replication rules.
QUERY SERVER	Displays information about servers.
QUERY STATUS	Displays the settings of server parameters, such as those selected by the SET commands.
REGISTER NODE	Defines a client node to the server and sets options for that user.
REMOVE REPLNODE	Removes a node from replication.
PROTECT STGPOOL	Protects a directory-container storage pool.
SET REPLRECOVERDAMAGED	Specifies whether node replication is enabled to recover damaged files from a target replication server.
UPDATE FILESPACE	Changes file-space node-replication rules.
UPDATE NODE	Changes the attributes that are associated with a client node.
UPDATE REPLRULE	Enables or disables replication rules.
VALIDATE REPLICATION	Verifies replication for file spaces and data types.