Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

10.8. 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 10.3.3, “Prerequisites”.
  2. Determine the appropriate deployment scenario. For more information on deployment scenarios, see Section 10.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:
      Copy to Clipboard Toggle word wrap 
      # 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 interimmaster nodes.
      Copy to Clipboard Toggle word wrap 
      # 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:
      Copy to Clipboard Toggle word wrap 
      # gluster volume geo-replication master-vol interimhost::interimmaster-vol status
  4. Start a Geo-replication session between the hosts:
    Copy to Clipboard Toggle word wrap 
    # 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:
    Copy to Clipboard Toggle word wrap 
    # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol status
  6. Create a geo-replication session between interimmaster-vol and slave-vol.
    1. Create a common pem pub file by running the following command on the interimmaster master node where the password-less SSH connection is configured:
      Copy to Clipboard Toggle word wrap 
      # gluster system:: execute gsec_create
    2. On interimmaster node, 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.
      Copy to Clipboard Toggle word wrap 
      # gluster volume geo-replication interimmaster-vol slave_host.com::slave-vol create push-pem
    3. Verify the status of the created session by running the following command:
      Copy to Clipboard Toggle word wrap 
      # gluster volume geo-replication interrimmaster-vol slave_host::slave-vol status
  7. Start a geo-replication session between interrimaster-vol and slave-vol by running the following command:
    Copy to Clipboard Toggle word wrap 
    # gluster volume geo-replication interrimmaster-vol slave_host.com::slave-vol start
  8. Verify the status of geo-replication session by running the following:
    Copy to Clipboard Toggle word wrap 
    # gluster volume geo-replication interrimmaster-vol slave_host.com::slave-vol status
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.