ADMINISTERING
You can view cluster replication events and statistics from the Domino® Administrator or in the server log file. You can see information on cluster replication activity, workload, and status, and use statistics to find replication backlogs.
Viewing cluster replication events
About this task
The Cluster Replicator generates Notes® Log Replication documents once an hour and records information about all replication performed during that hour. Each Notes Log Replication document provides information about database replication and any errors that currently exist. An error indicates that an item couldn't be replicated. This is often due to the destination server being unavailable. When an error occurs, the Cluster Replicator retries the replication periodically until it is successful. After the replication is successful, the error is no longer recorded. The Cluster Replicator generates one Notes Log Replication document for each server with which it replicates.
You can view cluster replication events that the Cluster Replicator generates.
From the Domino Administrator
Procedure
1. In the Server pane, expand either All Servers or Clusters.
2. Select the server that stores the log file you want to view.
3. Click the Server -> Analysis tab.
4. In the Task pane, expand Notes Log or server name Log, and then click Replication Events.
5. In the Results pane, open the replication document you want to view.
From the Domino server log file
1. Open the Domino server log file.
2. Open the Replication Events view.
3. Open the Notes Log Replication document you want to view.
Example of viewing cluster replication events
The following example shows two databases successfully replicated by the Cluster Replicator from the server Sales/Acme to the server Sales2/Renovations. A third database, CUSTOMER.NSF, was modified on Sales/Renovations but was not replicated to Sales2/Renovations because the server became unavailable.
Sales/Renovations09/04 03:50 PM - 09/04 03:50 PM Remote Server: Sales2/RenovationsInitiated By: CLUSTER REPLICATOR ON SALES/RENOVATIONSElapsed Time: 0 minutes EventsUnable to replicate from customer.nsf to Sales2/Renovations customer.nsf: Remote system no longer responding Database Access Added Deleted Updated KBrec KBsent From Sales2 Manager 34 0 1 3 15 cldbdir.nsfcldbdir.nsf Sales2 Manager 0 2 2 1 13 names.nsfnames.nsf
Tip: Run Log Analysis to search the log file (LOG.NSF) and gather all of the replication events into a database.
Viewing cluster replication statistics
You can view cluster replication statistic reports, or you can view a list of cluster replication statistics.
Viewing cluster replication statistic reports
You can use the Domino Administrator to view replication statistic reports in the Monitoring Results database.
Before using this procedure, you must enable statistic reporting in the Monitoring Results database.
1. In the Server pane of the Domino Administrator, expand either All Servers orClusters.
2. Select the server you want.
4. In the Task pane, expand Monitoring Results, and then expand Statistics Reports.
5. Click Clusters.
6. In the Results pane, open the document you want, and then look in the Replica cluster statistics section of the document.
Results
Note: If you prefer, you can view these reports directly in the Monitoring Results database (STATREP.NSF). Open the database, expand Statistics Reports, and then click Clusters.
Viewing a list of cluster replication statistics
You can view a list of cluster replication statistics from the Domino Administrator or the server console.
3. Click the Server -> Statistics tab.
4. In the statistics list, expand Replica, and then expand Cluster.
From the server console
Send the following Domino command from the server console:
show stat replica.cluster*
The cluster replication statistics begin with "Replica.Cluster." They give you information about cluster replication events, such as the number of documents updated, the number of times the Cluster Replicator retried pending replication, and the number of bytes received during cluster replication.
Using cluster replication statistics to find replication backlogs
During peak activity periods, servers may show an especially high frequency of replication events. Replication backlogs may occur if the Cluster Replicator is unable to handle all replication requests.
Examine the Replica.Cluster.WorkQueueDepth statistic. This statistic shows the number of modified databases awaiting replication. In addition, examine the Replica.Cluster.SecondsOnQueue statistic. This statistic shows how long a database waited to be replicated. If the number of databases waiting to be replicated is consistently much greater than zero, or if the amount of time a database waits to be replicated is consistently longer than you would like, consider using multiple Cluster Replicators to help decrease the replication backlog. You could also decrease the server workload by removing very active databases from the server or by decreasing the number of users who can access the server.
Related tasks Viewing Cluster Manager events and statistics Enabling statistic reporting in the Monitoring Results database Searching and viewing the Domino server log file (LOG.NSF) Using multiple Cluster Replicators
Related reference Understanding cluster statistics