https://fedoraproject.org/wiki/Changes/Stratis_3.1.0

This document represents a proposed Change. As part of the Changes process, proposals are publicly announced in order to receive community feedback. This proposal will only be implemented if approved by the Fedora Engineering Steering Committee.

== Summary == Stratis 3.1.0 includes significant improvements to the management of the thin-provisioning layers, as well as a number of other user-visible enhancements and bug fixes.

== Owner == * Name: ** [[User:dkeefe|Dennis Keefe]] ** [[User:mulhern|Anne Mulhern]] ** [[User:jbaublitz|John Baublitz]]

* Email: ** dkeefe@redhat.com ** amulhern@redhat.com ** jbaublitz@redhat.com

== Detailed Description == Stratis 3.1.0 includes significant improvements to the management of the thin-provisioning layers, as well as a number of other user-visible enhancements and bug fixes.

Please see this [https://stratis-storage.github.io/thin-provisioning-redesign/ post] for a detailed discussion of the thin-provisioning changes. To support these changes the Stratis CLI has been enhanced to:

* allow specifying whether or not a pool may be overprovisioned on creation * allow changing whether or not a pool may be overprovisioned while it is running * allow increasing the filesystem limit for a given pool * display whether or not a pool is overprovisioned in the pool list view

Users of the Stratis CLI may also observe the following changes:

* A `debug` subcommand has been added to the `pool`, `filesystem`, and `blockdev` subcommands. Debug commands are not fully supported and may change or be removed at any time. * The `--redundancy` option is no longer available when creating a pool. This option had only one permitted value so specifying it never had any effect.

stratisd 3.1.0 includes one additional user-visible change:

* The minimum size of a Stratis filesystem is increased to 512 MiB.

stratisd 3.1.0 also includes a number of internal improvements:

* The size of any newly created MDV is increased to 512 MiB. * A pool's MDV is mounted in a private mount namespace and remains mounted while the pool is in operation. * Improved handling of udev events on device removal. * The usual and customary improvements to log messages. Please consult the [https://github.com/stratis-storage/stratisd/blob/master/CHANGES.txt/ stratisd] and [https://github.com/stratis-storage/stratis-cli/blob/master/CHANGES.txt/ stratis-cli] changelogs for additional information about the 3.1.0 release.

== Benefit to Fedora == Users of Fedora will now benefit from Stratis 3.1.0 by: * Change the overprovisioning mode at create time or while running * User can increase the limit of filesystems per pool. The default is 100. * Stratis pool list will display whether or not a pool is overprovisioned * The MDV size is now 512MB, which allows for more filesystems to be created per pool * MDV is now in a private mount namespace, which decreases logging events and user may see faster completion times for commands that required the MDV to be mounted.

== Scope == * Proposal owners: ** Update existing stratis-cli package to specify new release ** Update existing stratisd package to specify new release * Other developers: N/A * Release engineering: Self Contained * Policies guidelines: N/A * Trademark approval: N/A

== How To Test == * To see the `overprovisioning` field, list the pools `stratis pool list`

overprovisioned will equal `OP`, no overprovisioning will equal `~OP`

* To set the filesystem limit of a pool: `stratis pool set-fs-limit p1 200`

* To see what the filesystem limit is `stratis report engine_state_report`

Look for field `fs_limit` in output

== User Experience == Other than the changes mentioned above the user experience will be the same.

== Dependencies == No new dependencies

== Contingency Plan == * Contingency mechanism: * Contingency deadline: N/A * Blocks release? No * Blocks product? No

== Documentation == * This content can be viewed on Developer’s [https://stratis-storage.github.io/thin-provisioning-redesign/ blog] for Stratis 3.1 * Thin-provisioning [https://stratis-storage.github.io/thin-provisioning-redesign/ blog] * [https://github.com/stratis-storage/stratisd/blob/master/CHANGES.txt/ stratisd] changelog * [https://github.com/stratis-storage/stratis-cli/blob/master/CHANGES.txt/ stratis-cli] changelog

== Release Notes == [https://stratis-storage.github.io/stratis-release-notes-3-1-0/ Stratis Release Notes]

-- Vipul Siddharth He/His/Him Fedora | CentOS CI Infrastructure Team