Database Replication Guide (PDF)

Database Replication Guide — Chapter 4

« Previous chapter

Checking Database Replication Status

This chapter describes how to check replication status for a Master cluster. This chapter includes the following sections:

This chapter includes the following sections:

Checking the State of the Replica Forests

This section describes how to check the state of each Replica forest on the Replica cluster.

  1. Access the Admin Interface on the bootstrap host in the Replica cluster. Navigate to the Replica database in the left-hand menu:

  2. Select the Status tab:

  3. The current state of each Replica forest appears near the top of the page.

The possible states related to Database Replication are listed in the table below.

State Description
Open Replica The Replica forest is currently receiving replicated data in the form of journal frames from the Master forest. This is the normal state for Database Replication.
Syncing Replica The Replica forest is bulk synchronizing with the Master forest. This occurs when a Master database containing documents is initially configured for Database Replication, after the Master and Replica have been detached for a sufficiently long period of time that journal replay is no longer possible, or following a local-disk failover. Once the Master and Replica databases are synchronized, the state is reset to Open Replica.

While in this state, the status page will report that the database forests are in an error state. There is nothing wrong with the forests and they will appear as normal when the database returns to the Open Replica state.

Checking the Journal Frames Received from the Master

This section describes how to check the current journal frames received by each Replica forest from the Master.

  1. On the bootstrap host in the Replica cluster, navigate to the Replica database in the left-hand menu and select Database Replication:

  2. Select the Summary tab:

    Field Description
    Foreign Precise Time The point in time the foreign Master forest asserted itself as a Master. If local-disk failover isn't configured on the Master, this is the time the forest was created, last cleared, last rolled back, and so on. If the foreign Master has local-disk failover configured, in addition to the previously mentioned events, this could be the time of the last failover.
    Foreign FSN The ID of the last journal frame received from the foreign Master. The ID is simply the current count of journal frames.

Checking the Update Lag on the Master

As described in Replication Lag, the Replica cluster sends an acknowledgement to the Master cluster when a replicated journal frame has been received and stored. The Lag Limit you set in your Master cluster configuration specifies that transactions on the Master will be stalled if the Master does not receive an acknowledgement from the Replica within the number of seconds specified by the Lag Limit. If the Pending-Lag value exceeds the Lag-Limit, new transactions that access the Master database are stalled.

If the XDQP timeout value set for the Replica cluster is exceeded, the Replica cluster is assumed to have failed. In this event, the Master cluster will detach from the Replica and transactions will continue normally on the Master. When the Replica cluster is available again, Database Replication will resume and the Replica database will resynchronize with the Master database.

You can check for lagging updates at the bottom of the database status page. For example, to check the Database Replication status of the Documents database do the following:

  1. On the bootstrap host in the Master cluster, navigate to the Master database in the left-hand menu and select Database Replication:

  2. Select the Summary tab:

    Field Description
    Local-Forest-Name The name of the Master forest.
    Foreign-Forest-Name The name of the Replica forest.
    Foreign-Database-Name The name of the Replica database.
    Pending-Frames The number of unreplicated journal frames.
    Pending-Bytes The number of unreplicated bytes.
    Pending-Lag The number of seconds since the last journal frame was replicated.
    Lag-Limit The current lag limit set for this database. For details on the lag limit, see Replication Lag.

« Previous chapter
Powered by MarkLogic Server | Terms of Use | Privacy Policy