Configuring Secure Clusters for Cross-Cluster Mirroring and Replication
Describes configuring clusters for cross-cluster operations such as mirroring and replication.
About this task
- Volume mirroring is a pull operation. The destination cluster pulls the volume data from the source cluster. Since the destination cluster performs the operation, the destination cluster receives a ticket that is generated on the source cluster.
- Table and streams replication is a push operation. The source cluster pushes table or stream data to the destination cluster. Since the source cluster performs the operation, the source cluster receives a ticket that is generated on the destination cluster.
You can configure secure clusters for cross-cluster mirroring and replication manually
(as described in Manually Setting up Secure Clusters for Cross-Cluster Mirroring and Manually Setting up Secure Clusters for Cross-Cluster Replication). You can configure secure clusters
automatically, by running the configure-crosscluster.sh
utility. This
utility configures the clusters for both mirroring and replication in both directions.
For more information, see configure-crosscluster.sh
.
Manually Setting up Secure Clusters for Cross-Cluster Mirroring
About this task
Procedure
-
Verify that the user for whom you are configuring access, exists in the registry
on both the clusters and has the following permissions:
- Permissions to create volumes on the source cluster.
- Permissions to mirror volumes on the destination cluster.
You can set up access for the mapr user, who already has permissions to create volumes and mirror volumes. -
Configure clusterA to communicate with the other clusters by editing the
mapr-clusters.conf
file on each node of clusterA to specify the hostname or IP address of the CLDB nodes on the other clusters.For example, suppose:- clusterA’s
/opt/mapr/conf/mapr-clusters.conf
file contains the following:clusterA.cluster.com secure=true perfnode50.lab:7222
- clusterB’s
/opt/mapr/conf/mapr-clusters.conf
file contains the following:clusterB.cluster.com secure=true perfnode100.lab:7222
Perform the following steps to configure the nodes on the clusters:
Seemapr-clusters.conf
. - clusterA’s
-
Log in to any node on the source cluster (ClusterA) and perform the following
steps:
-
Log in to the node on the destination cluster (clusterB) where the cross-cluster
ticket was copied, and perform the following steps:
-
Perform the following steps on clusterB to ensure that the
ssl_truststore
file has signers for all the clusters: - Perform the steps to verify configuration for mirroring.
Results
For example, suppose there are two clusters, clusterA and clusterB, and you performed the steps above for clusterA as the source cluster and clusterB as the destination cluster. After you complete the steps above, your destination cluster, clusterB can pull data from volumes on clusterA. For clusterA to mirror data on clusterB, perform the steps above with clusterB as the source cluster and clusterA as the destination cluster.
Manually Setting up Secure Clusters for Cross-Cluster Replication
About this task
Procedure
- Verify that the user, for whom you are configuring access, exists in the registry on the destination cluster.
-
Log in to any node on the destination cluster and perform the following steps:
-
Log in to the node in the source cluster where the cross-cluster ticket was
copied, and perform the following steps:
-
Configure the Gateway for table and streams replication.
See Configuring Gateways for Table and Stream Replication for more information.
- Perform the steps to verify configuration for replication.
Results
For example, suppose there are two clusters, clusterA and clusterB, and you performed the steps above for clusterA as the source cluster and clusterB as the destination cluster. After you complete the steps above, your source cluster, clusterA can push data to replicas on clusterB. For clusterB to replicate data on clusterA, perform the steps above with clusterB as the source cluster, and clusterA as the destination cluster.
Verifying Cross-Cluster Configuration for Mirroring and Replication
About this task
Procedure
-
Mirroring by logging in to a node on the destination cluster as the user for
whom access was configured, and creating a mirror volume on the destination
cluster for a volume on the source cluster.
You can create mirror volumes using the Control System and/or the CLI.
-
Replication by logging in to a node on the source cluster as the user for whom
access was configured and creating a replica in the destination cluster for a volume,
table, and stream on the source cluster.
You can create replicas using the Control System and the CLI. To set up replication on secure clusters for:
- Tables, refer to the documentation for the Control System and/or the CLI.
- Streams, refer to the documentation for the Control System and/or the CLI.