ceph/doc/radosgw/upgrade_to_jewel.rst
Kefu Chai a365999c99 docs/radosgw: fix sphinx warning
* upgrade_to_jewel.rst: silence following warning
  upgrade_to_jewel.rst:1: WARNING: Title overline too short.
* index.rst: add links to not-included docs
  add api.rst, layout.rst and upgrade_to_jewel.rst to toc
  silences warning like
  api.rst:: WARNING: document isn't included in any toctree

Signed-off-by: Kefu Chai <kchai@redhat.com>
2017-03-16 16:38:30 +08:00

44 lines
1.6 KiB
ReStructuredText

=================================================================
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
Non default setting for `rgw region root pool`
==============================================
If an existing multisite configuration uses a non-default setting for
`rgw region root pool`, the new pool settings `rgw zonegroup root pool`,
`rgw period root pool` and `rgw realm root pool` should be set to match.
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.