From: Orit Wasserman <owasserm@redhat.com>
Date: Tue, 8 Nov 2016 12:50:02 +0000 (+0100)
Subject: rgw: add recovery procedure for upgrade to older version of jewel
X-Git-Tag: v10.2.6~65^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=7db6d1d13dc62ca0f00ed29f3a94dcc48481966f;p=ceph.git

rgw: add recovery procedure for upgrade to older version of jewel

Fixes: http://tracker.ceph.com/issues/17820
Signed-off-by: Orit Wasserman <owasserm@redhat.com>
(cherry picked from commit 6d8f7bfe59600d122c4c095d8a4adb19a41c761e)
---

diff --git a/doc/radosgw/upgrade_to_jewel.rst b/doc/radosgw/upgrade_to_jewel.rst
new file mode 100644
index 0000000000000..dbe1f741f2ae6
--- /dev/null
+++ b/doc/radosgw/upgrade_to_jewel.rst
@@ -0,0 +1,37 @@
+=============
+RGW upgrading to Jewel versions 10.2.0, 10.2.1, 10.2.2 and 10.2.3
+=============
+
+.. versionadded:: Jewel
+
+Upgrade of :term:`Ceph Object Gateway` to older versions of jewel (up to 10.2.3 included) caused issues. This document describes the needed recovery procedure.
+
+Mixed version of :term:`Ceph Object Gateway` is not supported
+
+Backup of old configuration
+================
+rados mkpool .rgw.root.backup
+rados cppool .rgw.root .rgw.root.backup
+
+Fix confgiuration after upgrade
+================
+Stop all :term:`Ceph Object Gateway` running in the cluster.
+
+Run the following commands:::
+
+  $ rados rmpool .rgw.root
+
+  $ radosgw-admin zonegroup get --rgw-zonegroup=default | sed 's/"id":.*/"id": "default",/g' | sed 's/"master_zone.*/"master_zone":"default",/g' > default-zg.json
+
+  $ raodsgw-admin zone get --zone-id=default > default-zone.json
+
+  $ radosgw-admin realm create --rgw-realm=myrealm
+
+  $ radosgw-admin zonegroup set --rgw-zonegroup=default --default < default-zg.json
+
+  $ radosgw-admin zone set --rgw-zone=default --default < default-zone.json
+
+  $ radosgw-admin period update --commit
+
+Start all :term:`Ceph Object Gateway` in the cluster.
+