A newer version of this documentation is available.

View Latest

Prepare for XDCR

      +
      Before setting up a replication, make sure you have the appropriate administrative roles. Then, make sure your cluster is appropriately configured and provisioned.

      Establish Roles for XDCR

      Couchbase Server enforces Role-Based Access Control. This means that to access specific system-resources, corresponding privileges are required. Privileges have a fixed association with roles, which are assigned to users.

      Full information on Role-Based Access Control is provided in Authorization. If you possess the role of Full, Cluster, or XDCR Administrator, you can create, edit, and delete cluster references and replications.

      Prepare Your Cluster for XDCR

      Before beginning XDCR management:

      • Configure all nodes within the source cluster so that they can individually communicate over the network to all nodes within the target cluster.

      • Ensure that all Couchbase Server platforms match. For instance, if you want to replicate from a Linux-based cluster, you need to do so with another Linux-based cluster.

      • Confirm that your cluster is properly sized, and is able to handle new XDCR streams. For example, XDCR needs 1-2 additional CPU cores per stream; and in some cases, will require additional RAM and network resources as well. If a cluster is not sized to handle both the existing workload and the new XDCR streams, the performance of both XDCR and the cluster overall may be negatively impacted.

      • Couchbase Server uses TCP/IP port 8091 to exchange cluster configuration information. If you are communicating with a destination cluster over a dedicated connection, or over the Internet, ensure that all nodes in the destination and source clusters can communicate with each other over ports 8091 and 8092.

      Next Steps

      Once your source and target clusters have been prepared, to start XDCR management, Create a Reference.