autoscaling, see :ref:`pg-autoscaler`. Note that existing pools in
upgraded clusters will still be set to ``warn`` by default.
+* The pool parameter ``target_size_ratio``, used by the pg autoscaler,
+ has changed meaning. It is now normalized across pools, rather than
+ specifying an absolute ratio. For details, see :ref:`pg-autoscaler`.
+ If you have set target size ratios on any pools, you may want to set
+ these pools to autoscale ``warn`` mode to avoid data movement during
+ the upgrade::
+
+ ceph osd pool set <pool-name> pg_autoscale_mode warn
+
* The ``upmap_max_iterations`` config option of mgr/balancer has been
renamed to ``upmap_max_optimizations`` to better match its behaviour.