10.11. Recommended Practices

Manually Setting the Time on Bricks in a Geo-replication Environment

1. Stop geo-replication between the master and slave, using the following command:

   # gluster volume geo-replication MASTER_VOL SLAVE_HOST::SLAVE_VOL stop

2. Stop geo-replication indexing, using the following command:

   # gluster volume set MASTER_VOL geo-replication.indexing off

3. Set a uniform time on all the bricks.
4. Restart the geo-replication sessions, using the following command:

   # gluster volume geo-replication MASTER_VOL SLAVE_HOST::SLAVE_VOL start

Initially Replicating to a Remote Slave Locally using a LAN

1. Create a geo-replication session locally within the LAN. For information on creating a geo-replication session, see Section 10.3.4.1, “Setting Up your Environment for Geo-replication Session”.

   Important

   You must remember the order in which the bricks/disks are specified when creating the slave volume. This information is required later for configuring the remote geo-replication session over the WAN.
2. Ensure that the initial data on the master is synced to the slave volume. You can verify the status of the synchronization by using the status command, as shown in Section 10.4.3, “Displaying Geo-replication Status Information”.
3. Stop and delete the geo-replication session.
   For information on stopping and deleting the the geo-replication session, see Section 10.4.5, “Stopping a Geo-replication Session” and Section 10.4.6, “Deleting a Geo-replication Session”.

   Important

   You must ensure that there are no stale files in /var/lib/glusterd/geo-replication/.
4. Stop and delete the slave volume.
   For information on stopping and deleting the volume, see Section 11.13, “Stopping Volumes” and Section 11.14, “Deleting Volumes”.
5. Remove the disks from the slave nodes, and physically transport them to the remote location. Make sure to remember the order in which the disks were specified in the volume.
6. At the remote location, attach the disks and mount them on the slave nodes. Make sure that the file system or logical volume manager is recognized, and that the data is accessible after mounting it.
7. Configure a trusted storage pool for the slave using the peer probe command.
   For information on configuring a trusted storage pool, see Chapter 4, Adding Servers to the Trusted Storage Pool.
8. Delete the glusterFS-related attributes on the bricks. This should be done before creating the volume. You can remove the glusterFS-related attributes by running the following command:

   # for i in `getfattr -d -m . ABSOLUTE_PATH_TO_BRICK 2>/dev/null | grep trusted | awk -F = '{print $1}'`; do setfattr -x $i ABSOLUTE_PATH_TO_BRICK; done

   Run the following command to ensure that there are no xattrs still set on the brick:

   # getfattr -d -m . ABSOLUTE_PATH_TO_BRICK

9. After creating the trusted storage pool, create the Red Hat Gluster Storage volume with the same configuration that it had when it was on the LAN. For information on creating volumes, see Chapter 5, Setting Up Storage Volumes.

   Important

   Make sure to specify the bricks in same order as they were previously when on the LAN. A mismatch in the specification of the brick order may lead to data loss or corruption.
10. Start and mount the volume, and check if the data is intact and accessible.
    For information on starting and mounting volumes, see Section 5.10, “Starting Volumes” and Chapter 6, Creating Access to Volumes.
11. Configure the environment and create a geo-replication session from the master to this remote slave.
    For information on configuring the environment and creating a geo-replication session, see Section 10.3.4.1, “Setting Up your Environment for Geo-replication Session”.
12. Start the geo-replication session between the master and the remote slave.
    For information on starting the geo-replication session, see Section 10.4, “Starting Geo-replication”.
13. Use the status command to verify the status of the session, and check if all the nodes in the session are stable.
    For information on the status, see Section 10.4.3, “Displaying Geo-replication Status Information”.