Database Replication Quick Start

This section 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 one another and they must not be on the same cluster.

This section includes the following sections:

• Identify the Local Cluster to Foreign Clusters
• Couple the Local Cluster with the Foreign Cluster
• Configure Database Replication
• Load Documents into the Primary Database and Check Replication

All procedures in this section are done through the Admin Interface. See Administrative Interface section in Administrate MarkLogic Server.

Identify the Local Cluster to Foreign Clusters

You can configure each cluster with a descriptive name. Best practice is to assign each cluster a name before coupling them with each other.

These steps show how to name the local cluster so that it can be identified by foreign clusters. Repeat these steps 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 from the left menu tree:

   

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. Coupling the local cluster to the foreign cluster makes the clusters aware of each other. See Coupling Clusters in Administrate MarkLogic Server.

Configure Database Replication

Follow these steps to replicate the Documents database on the primary to the Documents database on the replica:

1. On the primary host, navigate to the Documents database in the left menu tree, and select Database Replication:

   

2. Select the Configure tab then select the foreign cluster from the Foreign Cluster dropdown. Click ok:

   

3. On the Configure Database Replication page, select master (primary) for Local Database as:

   

4. Select Documents from the Foreign Database dropdown. Leave all other settings as default. Click ok:

   

5. Click ok on the Configure Database Replication confirmation page to confirm the database replication configuration on the primary:

   

6. Click ok on the Confirm to Add Foreign Replica page that appears:

   

7. The Summary page appears with the database replication settings:

   

Load Documents into the Primary Database and Check Replication

Now that the database replication configuration is complete, any documents loaded into the Documents database on the primary host will be replicated to the Documents database on the replica host.

Here are some methods for loading content into a database:

• Using MarkLogic Content Pump.
• Using the XQuery load document functions as described in Loading Content Using XQuery in Load Content into MarkLogic Server.
• Setting up a WebDAV server and client, such as Windows Explorer, to load your documents. See Simple Drag-and-Drop Conversion in Content Processing Framework for information on how to configure a WebDAV server to work with Windows Explorer.
• Creating an XCC application as described in Using the Sample Applications in Develop with XCC.

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 Use Query Console.