Using Tell commands to display cluster replication information

You can use Tell server commands to display additional information about cluster replication. This information helps you determine whether to make any changes to the way you configured cluster replication or to the way you balanced the workload in the cluster. The information is displayed on the server console.

Using Tell commands from the Domino® Administrator

Procedure

  1. In the Server pane, expand either All Servers or Clusters.
  2. Select the server you want.
  3. Click the Server > Status tab.
  4. In the Task pane, click Server Tasks.
  5. In the Results pane, click Cluster Replicator.
  6. In the Tools pane, expand Task, and then click Tell.
  7. In the Tell Cluster Replicator dialog box, click the Dump tab.
  8. Select one of the following, and then click OK.
    • Everything
    • All known cluster mates
    • All databases that have failed to replicate

Using Tell commands from the Web Administrator

Procedure

  1. In the Server pane, expand either All Servers or Clusters.
  2. Select the server you want.
  3. Click the Server > Status tab.
  4. In the Task pane, click All Server Tasks.
  5. In the Results pane, click Cluster Replicator.
  6. In the Tools pane, expand Task, and then click Tell.
  7. In the Tell Task dialog box, enter one of the following, and then click OK.
    • tell clrepl dump
    • tell clrepl dump server
    • tell clrepl dump retry

What to do next

The following table describes the cluster replication Tell commands used in the preceding procedures.

Table 1. Tell commands for cluster replication

Choice in Domino® Administrator

Command in Web Administrator

Information displayed

Use

Everything

tell clrepl dump
  • The number of Cluster Replicators running
  • The work queue depth
  • The number of cluster replication retries in progress
  • The last time cluster replication was unsuccessful
  • The time of the last retry with each of the other cluster servers
  • Whether retry is currently in progress
  • The following information for each replication that still must be retried: the name of the database, the time the next retry is due, and the retry interval
  • Some statistics and other information about every database on the current server that has a replica in the cluster, as long as the replica does not have cluster replication disabled. Also, information about those replicas.
  • To view the status of cluster replication
  • To see which databases did not replicate and which replicas are not up-to-date
  • To determine if cluster replication is being delayed due to long queues or to replication that needs to be retried
  • To determine whether to make any changes to the way you have configured cluster replication.
  • To determine if you want to change the availability threshold on a server or redistribute replicas in the cluster
  • To determine if you want to force the Cluster Replicator to retry all failed replications immediately rather than waiting for the next scheduled retry

All known cluster mates

tell clrepl dump server
  • The number of Cluster Replicators running
  • The work queue depth
  • The number of cluster replication retries in progress
  • The last time cluster replication was unsuccessful with each of the other cluster servers
  • The last time replication was retried with each of the other cluster servers
  • To view the status of cluster replication
  • To see how long it has been since the Cluster Replicator attempted to replicate each database that needs to be retried

All databases that have failed to replicate

tell clrepl dump retry
  • The number of Cluster Replicators running
  • The work queue depth
  • The number of cluster replication retries in progress
  • The names of the databases that are waiting to be replicated
  • The time the next retry is due for each database
  • The retry interval for each database
  • To view the status of cluster replication
  • To see which databases did not replicate
  • To see if particular servers are having problems so you can attend to those servers
  • To determine if you want the Cluster Replicator to retry all failed replications immediately rather than waiting for the next scheduled retry

Viewing the cluster replication information

About this task

The cluster replication information is automatically displayed on the server console. You can view the information there. In addition, if you've set up your system to write server console output to a file, you can view this information in the file. You can also view this information from the Domino® Administrator or the Web Administrator and copy the information from there to another program.

The following procedure tells how to copy the output information from the Domino® Administrator or the Web Administrator to another program.

Procedure

  1. From the Domino® Administrator or the Web Administrator, click the Server > Status tab.
  2. Do one of the following:
    • In the Task pane of the Domino® Administrator, click Server Console. Be sure that the console is not live.
    • In the Task pane of the Web Administrator, click Quick Console.
  3. In the Results pane, select the text you want to copy.
  4. Choose Edit > Copy.
  5. Paste the copied text into the program you want.