Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

10.9. 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 key-based SSH authentication connection is configured: 
      # gluster system:: execute gsec_create
      Copy to Clipboard
    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. 
      # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol create
push-pem
      Copy to Clipboard
    3. Verify the status of the created session by running the following command: 
      # gluster volume geo-replication master-vol interimhost::interimmaster-vol status
      Copy to Clipboard
  4. Configure the meta-volume for geo-replication: 
    # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol config use_meta_volume true
    Copy to Clipboard
    For more information on configuring meta-volume, see Section 10.3.5, “Configuring a Meta-Volume”.
  5. Start a Geo-replication session between the hosts: 
    # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol start
    Copy to Clipboard
    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.
  6. Verifying the status of geo-replication session by running the following command: 
    # gluster volume geo-replication master-vol interimhost.com::interimmaster-vol status
    Copy to Clipboard
  7. 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 key-based SSH authentication connection is configured: 
      # gluster system:: execute gsec_create
      Copy to Clipboard
    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. 
      # gluster volume geo-replication interimmaster-vol slave_host.com::slave-vol create push-pem
      Copy to Clipboard
    3. Verify the status of the created session by running the following command: 
      # gluster volume geo-replication interrimmaster-vol slave_host::slave-vol status
      Copy to Clipboard
  8. Configure the meta-volume for geo-replication: 
    # gluster volume geo-replication interrimmaster-vol slave_host::slave-vol config use_meta_volume true
    Copy to Clipboard
    For more information on configuring meta-volume, see Section 10.3.5, “Configuring a Meta-Volume”.
  9. Start a geo-replication session between interrimaster-vol and slave-vol by running the following command: 
    # gluster volume geo-replication interrimmaster-vol slave_host.com::slave-vol start
    Copy to Clipboard
  10. Verify the status of geo-replication session by running the following: 
    # gluster volume geo-replication interrimmaster-vol slave_host.com::slave-vol status
    Copy to Clipboard
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.