Search
SupportConsoleDevelopersStart a trialContact

10.5. Setting up Geo-replication using gdeploy

download PDF
This section describes how to use gdeploy to configure geo-replication, control and verify geo-replication sessions in your storage environment. The gdeploy tool automates the following processes related to geo-replication:

10.5.1. Setting up geo-replication as root user using gdeploy

Setting up a geo-replication session as a root user involves:
  1. Creating a common pem pub file
  2. Creating a geo-replication session
  3. Configuring the meta-volume
  4. Starting the geo-replication session
gdeploy helps in automating these tasks by creating a single configuration file. When gdeploy is installed, a sample configuration file is created in the following location: 
/usr/share/doc/gdeploy/examples/geo-replication.conf

Procedure 10.1. Setting up geo-replication as root user using gdeploy

Important

Ensure that the prerequisites listed in Section 10.3.3, “Prerequisites” are complete.
  1. Create a copy of the sample gdeploy configuration file present in the following location: 
    /usr/share/doc/gdeploy/examples/geo-replication.conf
  2. Add the required details in the geo-replication section of the configuration file using the following template: 
    [geo-replication]
action=create
mastervol=Master_IP:Master_Volname
slavevol=Slave_IP:Slave_Volname
slavenodes=Slave_IP_1,Slave_IP_2 [Add all slave IP addresses. Each address followed by a comma (,)]
force=yes [yes or no]
start=yes [yes or no]
  3. After modifying the configuration file, invoke the configuration using the command: 
    # gdeploy -c txt.conf
Following is an example of the modifications to the configuration file in order to set up geo-replication as a root user: 
[geo-replication]
action=create
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavesvolume
slavenodes=10.1.1.28,10.1.1.86
force=yes
start=yes
For more information on other available values, see Section 5.1.7, “Configuration File”

10.5.2. Setting up a secure geo-replication session using gdeploy

Setting up a secure geo-replication session involves:
  1. Creating a new group with a unprivileged account for all slave nodes
  2. Setting up the mountbroker
  3. Creating a common pem pub file
  4. Creating a geo-replication session
  5. Configuring the meta-volume
  6. Starting the geo-replication session
gdeploy helps in automating these tasks by creating a single configuration file. When gdeploy is installed, a sample configuration file is created in the following location: 
/usr/share/doc/gdeploy/examples/georep-secure.conf

Procedure 10.2. Setting up a secure geo-replication session using gdeploy

Important

Ensure that the prerequisites listed in Section 10.3.3, “Prerequisites” are complete.
  1. Create a copy of the sample gdeploy configuration file present in the following location: 
    /usr/share/doc/gdeploy/examples/georep-secure.conf
  2. Add the required details in the geo-replication section of the configuration file using the following template: 
    [geo-replication]
action=create
georepuser=User_Name [If the user is not present, gdeploy creates the geo-replication user.]
mastervol=Master_IP:Master_Volname
slavevol=Slave_IP:Slave_Volname
slavenodes=Slave_IP_1,Slave_IP_2 [Add all slave IP addresses. Each address followed by a comma (,)]
force=yes [yes or no]
start=yes [yes or no]
  3. After modifying the configuration file, invoke the configuration using the command: 
    # gdeploy -c txt.conf
The following is an example of the modifications to the configuration file in order to set up a secure geo-replication session: 
[geo-replication]
action=create
georepuser=testgeorep
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavesvolume
slavenodes=10.1.1.28,10.1.1.86
force=yes
start=yes
For more information on other available values, see Section 5.1.7, “Configuration File”

10.5.3. Controlling geo-replication sessions using gdeploy

gdeploy version 2.0.2-35 supports controlling geo-replication sessions on Red Hat Gluster Storage 3.5. Using gdeploy, the following actions can be performed for controlling a geo-replication session:
When gdeploy is installed, sample configuration files are created in /usr/share/doc/gdeploy/examples. The sample configuration file names for each action are as follows:
Table 10.1. gdeploy for Geo-replication Configuration File Names
Geo-replication Session Control Configuration File Name
Starting a sessiongeorep-start.conf
Stopping a sessiongeorep-stop.conf
Pausing a sessiongeorep-pause.conf
Resuming a sessiongeorep-resume.conf
Deleting a sessiongeorep-delete.conf

Procedure 10.3. Controlling geo-replication sessions using gdeploy

Warning

You must create a geo-replication session before controlling it. For more information, see any one of the following:

Important

Ensure that the prerequisites listed in Section 10.3.3, “Prerequisites” are complete.
  1. Create a copy of the required gdeploy sample configuration file present in the following location: 
    /usr/share/doc/gdeploy/examples
  2. Add the required information in the geo-replication section of the configuration file using the following template: 
    [geo-replication]
action=Action_Name
georepuser=User_Name If georepuser variable is omitted, the user is assumed to be root user.
mastervol=Master_IP:Master_Volname
slavevol=Slave_IP:Slave_Volname
slavenodes=Slave_IP_1,Slave_IP_2 [Add all slave IP addresses. Each address followed by a comma (,)]
force=yes [yes or no]
start=yes [yes or no]

    Important

    If georepuser variable is omitted, the user is assumed to be root user.
  3. After modifying the configuration file, invoke the configuration using the command: 
    # gdeploy -c txt.conf
Following are the examples of the modifications to the configuration file in order to control a geo-replication session:
Starting a geo-replication session

[geo-replication]
action=start
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavevolume
Stopping a geo-replication session

[geo-replication]
action=stop
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavevolume
force=yes
Pausing a geo-replication session

[geo-replication]
action=pause
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavevolume
force=yes
Resuming a geo-replication session

[geo-replication]
action=resume
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavevolume
force=yes
Deleting a geo-replication session

[geo-replication]
action=delete
mastervol=10.1.1.29:mastervolume
slavevol=10.1.1.25:slavevolume
force=yes
For more information on available values, see Section 5.1.7, “Configuration File”
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.

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.

© 2024 Red Hat, Inc.