Database Replication Guide (PDF)

MarkLogic 9 Product Documentation
Database Replication Guide
— Chapter 2

« Previous chapter
Next chapter »

Database Replication Quick Start

This chapter provides the quick-start procedures for creating a simple Database Replication configuration to replicate the Documents database from one MarkLogic Server host to another. The replicated MarkLogic Server hosts must be able to communicate with each other and they must not be on the same cluster.

The purpose of this chapter is to walk you through a specific Database Replication configuration procedure. For more general details on how to configure Database Replication, see Configuring Database Replication.

A cluster can consist of a single MarkLogic Server host.

This chapter includes the following sections:

All of the procedures described in this chapter are done using the Admin Interface described in the Administrative Interface chapter in the Administrator's Guide.

Identify the Local Cluster to Foreign Clusters

Each cluster may be configured to have a descriptive name. It is a good practice to assign each cluster a name before coupling them with each other.

This section describes how to name the local cluster so it can be identified by foreign clusters. Repeat this procedure on a host for each cluster that is to participate in Database Replication.

  1. On any host in the local cluster, select Local Cluster under Clusters at the bottom of the left-hand menu:

  2. In the Edit Local Cluster Configuration page, enter the cluster name and select a host as the bootstrap host:

Couple the Local Cluster with the Foreign Cluster

Before you can configure Database Replication, each cluster in the replication scheme must be aware of the configuration of the other clusters. This can be accomplished by coupling the local cluster to the foreign cluster.

  1. In the Local Cluster Configuration page, select the Couple tab.

  2. In the Foreign Cluster portion of the Local Cluster Configuration page, enter the Host Name for the bootstrap host in the foreign cluster. Leave the default values for the other settings and click OK.

  3. In the Specify SSL settings for XDQP communication & Timeouts page, leave all of the default settings and click OK.

  4. In the Confirm to Couple Clusters page, click OK. Click OK for any subsequent validate screens.

  5. The Summary window appears and displays the summary for the Foreign Cluster configuration.

Configure Database Replication

The procedure described in this section configures Database Replication to replicate the Documents database on the Master to the Documents database on the Replica.

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

  2. Select the Configure tab and select the foreign cluster from the pull-down menu. Click OK.

  3. In the Configure Database Replication page, set Master for Local Database as.

  4. Select the Documents database in the Foreign Database pull-down menu. Leave all other settings as default. Click OK.

  5. A page appears to confirm the Database Replication configuration on the Master. Click OK.

  6. The Confirm to Add Foreign Replica page appears. Click OK.

  7. The Summary page appears with the Database Replication settings.

Load Documents into the Master Database and Check Replication

Once you have completed the Database Replication configuration procedures described in this chapter, documents loaded into the Documents database on the Master host will be replicated to the Documents database on the Replica host.

Methods for loading content into a database include:

One way to confirm the content has been replicated to the Replica is to use the explore feature in Query Console to view the contents of the Replica database. For details on how to use Query Console to explore the contents of a database, see Exploring a Database in the Query Console User Guide.

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