Skip to content

gluster_georep

Sachidananda Urs edited this page May 18, 2018 · 1 revision

Abstract

Create/Delete/Start/Stop GlusterFS Geo-Replication sessions

Synopsis

The gluster_georep module creates/deletes/starts/stops/reconfigures the Geo-Replication sessions. Module expects master and slave GlusterFS volumes to be already created, with these parameters it establishes a Geo-Replication sessions between them. Once the session is created, the sessions can be configured using the module. Existing Geo-Replication sessions can be maintained using this module.

Requirements

  • GlusterFS >= 4.0

Parameters

Parameter Choices Default value Comments
state present / absent / started / stopped / paused /resumed NONE Create, delete, start, stop, pause, resume a geo-replication session
mastervol Mandatory variable. Master volume name for creating geo-replication session.
slavevol Mandatory variable. Slave volume name for creating geo-replication session.
force yes / no no Applicable only with states started, stopped, and while creating a Geo-Replication session. If force is set to yes, the volume will be started/stopped/created despite the client verification failure
georepuser root The Geo-Replication user to be used while performing any of Geo-Replication's administrative tasks. If no user is specified "root" is used.
gluster_log_file The path to the Geo-Replication glusterfs log file.
gluster_log_level INFO / DEBUG / WARNING / ERROR / CRITICAL / NONE / TRACE INFO The log level for glusterfs processes.
log_file The path to the geo-replication log file.
log_level INFO / DEBUG / WARNING / ERROR / CRITICAL / NONE / TRACE INFO The log level for geo-replication.
changelog_log_level INFO / DEBUG / WARNING / ERROR / CRITICAL / NONE / TRACE INFO The log level for the changelog.
ssh_command The SSH command to connect to the remote machine.
rsync_command The rsync command to use for synchronizing the files.
use_tarssh yes / no no The use-tarssh command allows tar over Secure Shell protocol. Use this option to handle workloads of files that have not undergone edits.
volume_id The command to delete the existing master UID for the intermediate/slave node.
timeout The timeout period in seconds.
sync_jobs The number of sync-jobs represents the maximum number of syncer threads (rsync processes or tar over ssh processes for syncing) inside each worker.
ignore_deletes If this option is set to 1, a file deleted on the master will not trigger a delete operation on the slave. As a result, the slave will remain as a superset of the master and can be used to recover the master in the event of a crash and/or accidental delete.
checkpoint Sets a checkpoint with the given option LABEL. If the option is set as `now', then the current time will be used as the label.
sync_acls true / false true Syncs acls to the Slave cluster. By default, this option is enabled. Geo-replication can sync acls only with rsync as the sync engine and not with tarssh as the sync engine.
sync_xattrs true / false true Syncs extended attributes to the Slave cluster. By default, this option is enabled.
log_rsync_performance true / false true If this option is set to enable, geo-replication starts recording the rsync performance in log files. By default, this option is disabled.
rsync_options Additional options to rsync. For example, you can limit the rsync bandwidth usage "--bwlimit=".
use_meta_volume true / false false Set this option to enable, to use meta volume in Geo-replicaiton. By default, this option is disabled.
meta_volume_mnt The path of the meta volume mount point.