From: Emmanuel Ameh Date: Tue, 23 Jun 2026 10:23:14 +0000 (+0100) Subject: doc/cephfs: clarify deprecated commands and remove obsolete upgrade path X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=b2ecec6b3a0b854c393232ed785c3953f87f7201;p=ceph.git doc/cephfs: clarify deprecated commands and remove obsolete upgrade path Several CephFS pages described deprecated commands and features without clear status or replacements, and one page documented an upgrade path that predates every supported release. * cephfs-mirroring: correct the peer_add deprecation note to reference the actual replacement command, peer_bootstrap create, and link the Bootstrap Peers section * kernel-features, experimental-features: state that inline data has been deprecated since the Octopus release and that enabling it triggers a health warning * upgrading: remove the "Upgrading pre-Firefly file systems past Jewel" section; the tmap_upgrade command it referenced was removed in Kraken Fixes: https://tracker.ceph.com/issues/77188 Signed-off-by: Emmanuel Ameh --- diff --git a/doc/cephfs/cephfs-mirroring.rst b/doc/cephfs/cephfs-mirroring.rst index cbd51081dfca..850c8fb972e6 100644 --- a/doc/cephfs/cephfs-mirroring.rst +++ b/doc/cephfs/cephfs-mirroring.rst @@ -173,8 +173,9 @@ and the user key. However, bootstrapping a peer is the recommended way to add a peer. .. note:: Only a single peer is currently supported. - The ``peer_add`` command is deprecated and will be removed in a future release. - Use the ``peer_bootstrap`` command instead. + The ``peer_add`` command is deprecated and will be removed in a future + release. Use the ``peer_bootstrap create`` command instead. See the + :ref:`Bootstrap Peers` section. To remove a peer, run a command of the following form: diff --git a/doc/cephfs/experimental-features.rst b/doc/cephfs/experimental-features.rst index f5f7ebba672f..00a53aaba59c 100644 --- a/doc/cephfs/experimental-features.rst +++ b/doc/cephfs/experimental-features.rst @@ -24,8 +24,8 @@ failures within it are unlikely to make non-inlined data inaccessible. Inline data has always been off by default and requires setting the ``inline_data`` flag. -Inline data has been declared deprecated for the Octopus release, and will -likely be removed altogether in a future release. +Inline data has been deprecated since the Octopus release. Enabling it triggers +a health warning, and the feature will be removed altogether in a future release. Mantle: Programmable Metadata Load Balancer ------------------------------------------- diff --git a/doc/cephfs/kernel-features.rst b/doc/cephfs/kernel-features.rst index 6dc66374d6fc..83c0a2f244bd 100644 --- a/doc/cephfs/kernel-features.rst +++ b/doc/cephfs/kernel-features.rst @@ -8,9 +8,9 @@ in the kernel driver. Inline data ----------- -Inline data was introduced by the Firefly release. This feature is being -deprecated in mainline CephFS, and may be removed from a future kernel -release. +Inline data was introduced by the Firefly release. This feature has been +deprecated since the Octopus release: enabling it triggers a health warning, +and it will be removed in a future release. Linux kernel clients >= 3.19 can read inline data and convert existing inline data to RADOS objects when file data is modified. At present, diff --git a/doc/cephfs/upgrading.rst b/doc/cephfs/upgrading.rst index 0396bd5c1a3c..7ca59200d232 100644 --- a/doc/cephfs/upgrading.rst +++ b/doc/cephfs/upgrading.rst @@ -54,37 +54,3 @@ command. Older versions of Ceph require you to stop these daemons manually. ceph fs set max_mds ceph fs set allow_standby_replay - -Upgrading pre-Firefly file systems past Jewel -============================================= - -.. tip:: - - This advice only applies to users with file systems - created using versions of Ceph older than *Firefly* (0.80). - Users creating new file systems 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 - -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 over all objects in your metadata -pool. It is safe to continue using your file system 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 file system 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. -