Ceph RGW Multisite - How to disable RGW Multisite sync temporarily?

Environment

• Red Hat Ceph Storage 2 and later

Issue

How to disable RGW Multisite sync temporarily?

Resolution

• RGW daemon has an option rgw_run_sync_thread which controls the RGW Multisite sync threads and this option is by default true.
• For disabling multisite sync temporarily, set this option value to false then RGW will not try to sync from other zones.
• Add this option rgw_run_sync_thread = false in all RGW instances ceph.conf section (or via config database on later versions) which are participating in Multisite sync in all the Multisite Ceph clusters.
• Changing this option needs RGW daemons to be restarted, please restart all RGW daemons one by one.
• For enabling RGW Multisite back please remove this option from all the RGW instances ceph.conf where it was added (or from the config database for later versions) and restart all RGW daemons one by one. This option will take back its default value as true and Multisite sync will start again.

Example for one instance in ceph.conf:

[client.rgw.us-east-rgw-1]
rgw_run_sync_thread = false
rgw_zone=us-east
[......]

When the deployment follows best practice as per solution 7025510 one can just stop the dedicated sync instances on all zones to disable replication temporarily.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.