1
0
mirror of https://github.com/ceph/ceph synced 2024-12-27 22:13:28 +00:00
ceph/doc/cephfs/upgrading.rst
John Spray e5641115e9 doc: add notes about upgrading cephfs
This is part of the run-up to removing all
TMAP code in the Jewel+1 cycle.

Signed-off-by: John Spray <john.spray@redhat.com>
2016-03-01 10:58:43 +00:00

35 lines
1.3 KiB
ReStructuredText

Upgrading pre-Firefly filesystems past Jewel
============================================
.. tip::
This advice only applies to users with filesystems
created using versions of Ceph older than *Firefly* (0.80).
Users creating new filesystems may disregard this advice.
Pre-firefly versions of Ceph used a now-deprecated format
for storing CephFS directory objects, called TMAPs. Support
for reading these in RADOS will be removed after the Jewel
release of Ceph, so for upgrading CephFS users it is important
to ensure that any old directory objects have been converted.
After installing Jewel on all your MDS and OSD servers, and restarting
the services, run the following command:
::
cephfs-data-scan tmap_upgrade <metadata pool name>
This only needs to be run once, and it is not necessary to
stop any other services while it runs. The command may take some
time to execute, as it iterates overall objects in your metadata
pool. It is safe to continue using your filesystem as normal while
it executes. If the command aborts for any reason, it is safe
to simply run it again.
If you are upgrading a pre-Firefly CephFS filesystem to a newer Ceph version
than Jewel, you must first upgrade to Jewel and run the ``tmap_upgrade``
command before completing your upgrade to the latest version.