13.0.1 ------ * *RGW, MON*: Commands variously marked as "del", "delete", "remove" etc. should now all be normalized as "rm". Commands already supporting alternatives to "rm" remain backward-compatible. * *CephFS*: * Upgrading an MDS cluster to 12.2.3+ will result in all active MDS exiting due to feature incompatibilities once an upgraded MDS comes online (even as standby). Operators may ignore the error messages and continue upgrading/restarting or follow this upgrade sequence: Reduce the number of ranks to 1 (`ceph fs set max_mds 1`), deactivate all other ranks (`ceph mds deactivate :`), shutdown standbys leaving the one active MDS, upgrade the single active MDS, then upgrade/start standbys. Finally, restore the previous max_mds. See also: https://tracker.ceph.com/issues/23172 * Several "ceph mds" commands have been obsoleted and replaced by equivalent "ceph fs" commands: - mds dump -> fs dump - mds getmap -> fs dump - mds stop -> mds deactivate - mds set_max_mds -> fs set max_mds - mds set -> fs set - mds cluster_down -> fs set cluster_down true - mds cluster_up -> fs set cluster_down false - mds add_data_pool -> fs add_data_pool - mds remove_data_pool -> fs rm_data_pool - mds rm_data_pool -> fs rm_data_pool * New CephFS file system attributes session_timeout and session_autoclose are configurable via `ceph fs set`. The MDS config options mds_session_timeout, mds_session_autoclose, and mds_max_file_size are now obsolete. * Each mds rank now maintains a table that tracks open files and their ancestor directories. Recovering MDS can quickly get open files' pathes, significantly reducing the time of loading inodes for open files. MDS creates the table automatically if it does not exist. * *RBD* * The RBD C API's rbd_discard method now enforces a maximum length of 2GB to match the C++ API's Image::discard method. This restriction prevents overflow of the result code. * The rbd CLI's "lock list" JSON and XML output has changed. * The rbd CLI's "showmapped" JSON and XML output has changed. * RBD now optionally supports simplified image clone semantics where non-protected snapshots can be cloned; and snapshots with linked clones can be removed and the space automatically reclaimed once all remaining linked clones are detached. This feature is enabled by default if the OSD "require-min-compat-client" flag is set to mimic or later; or can be overridden via the "rbd_default_clone_format" configuration option. * The sample ``crush-location-hook`` script has been removed. Its output is equivalent to the built-in default behavior, so it has been replaced with an example in the CRUSH documentation. * The "rcceph" script (systemd/ceph in the source code tree, shipped as /usr/sbin/rcceph in the ceph-base package for CentOS and SUSE) has been dropped. This script was used to perform admin operations (start, stop, restart, etc.) on all OSD and/or MON daemons running on a given machine. This functionality is provided by the systemd target units (ceph-osd.target, ceph-mon.target, etc.). * The python-ceph-compat package is declared deprecated, and will be dropped when all supported distros have completed the move to Python 3. It has already been dropped from those supported distros where Python 3 is standard and Python 2 is optional (currently only SUSE). * The -f option of the rados tool now means "--format" instead of "--force", for consistency with the ceph tool. >= 13.0.2 --------- The ceph-rest-api command-line tool (obsoleted by the MGR "restful" module and deprecated since v12.2.5) has been dropped. There is a MGR module called "restful" which provides similar functionality via a "pass through" method. See http://docs.ceph.com/docs/master/mgr/restful for details. >= 12.2.5 --------- The ceph-rest-api command-line tool included in the ceph-mon package has been obsoleted by the MGR "restful" module. The ceph-rest-api tool is hereby declared deprecated and will be dropped in Mimic. The MGR "restful" module provides similar functionality via a "pass through" method. See http://docs.ceph.com/docs/luminous/mgr/restful for details. 13.0.2 ------ * The format of the 'config diff' output via the admin socket has changed. It now reflects the source of each config option (e.g., default, config file, command line) as well as the final (active) value. * The `pg force-recovery` command will not work for erasure-coded PGs when a Luminous monitor is running along with a Mimic OSD. Please use the recommended upgrade order of monitors before OSDs to avoid this issue. * It is no longer possible to adjust ``pg_num`` on a pool that is still being created. 13.0.3 ------ * The ``osd_mon_report_interval_min`` option has been renamed to ``osd_mon_report_interval``, and the ``osd_mon_report_interval_max`` (unused) has been eliminated. If this value has been customized on your cluster then your configuration should be adjusted in order to avoid reverting to the default value.