gluster.gluster.geo_rep – Manage geo-replication sessions

Note

This plugin is part of the gluster.gluster collection (version 1.0.1).

To install it use: ansible-galaxy collection install gluster.gluster.

To use it in a playbook, specify: gluster.gluster.geo_rep.

Synopsis

  • Create, stop, delete and configure geo-replication session

Parameters

Parameter Choices/Defaults Comments
action
string / required
    Choices:
  • create
  • start
  • stop
  • delete
  • pause
  • resume
  • config
Action to be performed on geo-replication session.
changelog_log_level
string
The log level for the changelog.
checkpoint
string
Sets a checkpoint with the given option.
force
string
force the system to perform the action.
georepuser
string
Username to be used for the action being performed.
gluster_log_file
string
The path to the geo-replication glusterfs log file.
gluster_log_level
string
The log level for glusterfs processes.
ignore_deletes
string
file deletion on the master will not trigger a delete operation on the slave.
log_file
string
The path to the geo-replication log file.
log_level
string
The log level for geo-replication.
log_rsync_performance
string
for recording the rsync performance in log files.
mastervol
string
Master volume name.
meta_volume_mnt
string
The path of the meta volume mount point.
rsync_command
string
The command to use for setting synchronizing method for the files.
rsync_options
string
Additional options to rsync.
slavevol
string
Slave volume name.
ssh_command
string
The SSH command to connect to the remote machine.
sync_acls
string
Syncs acls to the Slave cluster.
sync_jobs
string
number of sync-jobs .
sync_xattrs
string
Syncs extended attributes to the Slave cluster.
timeout
string
timeout period.
use_meta_volume
string
to use meta volume in Geo-replication.
use_tarssh
string
To use tar over ssh.
volume_id
string
deletes the existing master UID for the intermediate/slave node.

Examples

- name: Create the geo-rep session
  gluster.gluster.geo_rep:
    action: create
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    force: true
    georepuser: staff
- name: Starts the geo-rep session
  gluster.gluster.geo_rep:
    action: start
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    force: true
    georepuser: staff
- name: Pause the geo-rep session
  gluster.gluster.geo_rep:
    action: pause
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    force: true
    georepuser: staff
- name: Resume the geo-rep session
  gluster.gluster.geo_rep:
    action: resume
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    force: true
    georepuser: staff
- name: Stop the geo-rep session
  gluster.gluster.geo_rep:
    action: stop
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    force: true
    georepuser: staff
- name: Configures the geo-rep session
  gluster.gluster.geo_rep:
    action: config
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    gluster_log_file: /var/log/glusterfs/geo-replication/gluster.log
    gluster_log_level: INFO
    log_file: /var/log/glusterfs/geo-replication/file.log
    log_level: INFO
    changelog_log_level: INFO
    ssh_command: SSH
    rsync_command: rsync
    use_tarssh: true
    volume_id: 6a071cfa-b150-4f0b-b1ed-96ab5d4bd671
    timeout: 60
    sync_jobs: 3
    ignore_deletes: 1
    checkpoint: now
    sync_acls: true
    sync_xattr: true
    log_rsync_performance: true
    rsync_options: --compress-level=0
    use_meta_volume: true
    meta_volume_mnt: /var/run/gluster/shared_storage/
- name: Delete the geo-rep session
  gluster.gluster.geo_rep:
    action: delete
    mastervol: 10.70.42.122:mastervolume
    slavevol: 10.70.43.48:slavevolume
    georepuser: staff

Authors

  • Sachidananda Urs (@sac)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/gluster/gluster/geo_rep_module.html