Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
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>
- Loading branch information
John Spray
committed
Mar 1, 2016
1 parent
0952f35
commit e564111
Showing
3 changed files
with
39 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
|
||
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. | ||
|