⁠12.7. Example - Setting up Cascading Geo-replication

This section provides step by step instructions to set up a cascading geo-replication session. The configuration of this example has three volumes and the volume names are master-vol, interimmaster-vol, and slave-vol.
  1. Verify that your environment matches the minimum system requirements listed in Section 12.3.3, “Prerequisites”.
  2. Determine the appropriate deployment scenario. For more information on deployment scenarios, see Section 12.3.1, “Exploring Geo-replication Deployment Scenarios”.
  3. Configure the environment and create a geo-replication session between master-vol and interimmaster-vol.
    1. Create a common pem pub file, run the following command on the master node where the password-less SSH connection is configured: 
      # gluster system:: execute gsec_create
    2. Create the geo-replication session using the following command. The push-pem option is needed to perform the necessary pem-file setup on the slave nodes. 
      # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol create
push-pem
    3. Verify the status of the created session by running the following command: 
      # gluster volume geo-replication master-vol interim_HOST::interimmaster-vol status
  4. Start a Geo-replication session between the hosts: 
    # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol start
    This command will start distributed geo-replication on all the nodes that are part of the master volume. If a node that is part of the master volume is down, the command will still be successful. In a replica pair, the geo-replication session will be active on any of the replica nodes, but remain passive on the others. After executing the command, it may take a few minutes for the session to initialize and become stable.
  5. Verifying the status of geo-replication session by running the following command: 
    # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol status
  6. To create a geo-replication session between interimmaster volume and slave volume, repeat step 3 to step 5 replacing master-vol with interimmaster-vol and interimmaster-vol with slave- vol. You must run these commands on interimmaster.
    Here, the interimmaster volume will act as the master volume for the geo-replication session between interimmaster and slave.