From Fedora Project Wiki

Stratis 3.1.0

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

  • Email: dkeefe@redhat.com, amulhern@redhat.com, jbaublitz@redhat.com


Current status

  • Targeted release: Fedora 37
  • Last updated: 2022-07-11
  • Devel list thread
  • FESCo issue: #2822
  • Tracker bug: <will be assigned by the Wrangler>
  • Release notes tracker: <will be assigned by the Wrangler>

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 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 stratisd and stratis-cli changelogs for additional information about the 3.1.0 release.

Feedback

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

Upgrade/compatibility impact

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

Release Notes

Stratis Release Notes