]> git.proxmox.com Git - ceph.git/blame - ceph/doc/radosgw/upgrade_to_jewel.rst
bump version to 12.0.3-pve3
[ceph.git] / ceph / doc / radosgw / upgrade_to_jewel.rst
CommitLineData
7c673cae
FG
1=================================================================
2RGW upgrading to Jewel versions 10.2.0, 10.2.1, 10.2.2 and 10.2.3
3=================================================================
4
5.. versionadded:: Jewel
6
7Upgrade 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.
8
9Mixed version of :term:`Ceph Object Gateway` is not supported
10
11Backup of old configuration
12===========================
13rados mkpool .rgw.root.backup
14rados cppool .rgw.root .rgw.root.backup
15
16Non default setting for `rgw region root pool`
17==============================================
18If an existing multisite configuration uses a non-default setting for
19`rgw region root pool`, the new pool settings `rgw zonegroup root pool`,
20`rgw period root pool` and `rgw realm root pool` should be set to match.
21
22Fix confgiuration after upgrade
23===============================
24Stop all :term:`Ceph Object Gateway` running in the cluster.
25
26Run the following commands:::
27
28 $ rados rmpool .rgw.root
29
30 $ radosgw-admin zonegroup get --rgw-zonegroup=default | sed 's/"id":.*/"id": "default",/g' | sed 's/"master_zone.*/"master_zone":"default",/g' > default-zg.json
31
32 $ raodsgw-admin zone get --zone-id=default > default-zone.json
33
34 $ radosgw-admin realm create --rgw-realm=myrealm
35
36 $ radosgw-admin zonegroup set --rgw-zonegroup=default --default < default-zg.json
37
38 $ radosgw-admin zone set --rgw-zone=default --default < default-zone.json
39
40 $ radosgw-admin period update --commit
41
42Start all :term:`Ceph Object Gateway` in the cluster.
43