8000 Stratis 3.8.1 release notes by mulkieran · Pull Request #367 · stratis-storage/stratis-docs · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Stratis 3.8.1 release notes #367

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 14, 2025
Merged

Stratis 3.8.1 release notes #367

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions content/stratis-release-notes-3.8.1.md
View file
Open in desktop
89AA
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
+++
title = "Stratis 3.8.1 Release Notes"
date = 2025-05-13
weight = 41
template = "page.html"
render = true
+++

*mulhern, Stratis Team*

Stratis 3.8.1, which consists of `stratisd 3.8.1` and `stratis-cli 3.8.1`
is a bug fix release which addresses the following problems.

For `stratis-cli`, the release fixes a bug where a user would be unable to
start an encrypted pool previously created with any Stratis release less
than 3.8.0.

`stratis-cli 3.8.1` also contains better organized help text and displays
more complete information in the pool detail view.

For `stratisd`, the release makes improvements to the Stratis support for
mounting filesystems at boot. It introduces a new systemd unit file,
`stratis-fstab-setup-with-network@.service`, which should be used when a
filesystem's pool requires unlocking with the network present, as is the
case when a pool is encrypted using NBDE (network-bound disk encryption).
The fstab entry for the filesystem _must_ include the `_netdev` option if this
systemd unit file is used.

If the `stratis-fstab-setup-with-network@service` unit is used and the
`_netdev` option is omitted in the same fstab entry, systemd will calculate
a cyclic dependency, and the boot process will fail.

An example fstab entry for a filesystem on a pool that is encrypted using
NBDE should look something like this:

`/dev/stratis/<POOL_NAME>/<FILESYSTEM_NAME> <MOUNTPOINT> xfs defaults,_netdev,x-systemd.requires=stratis-fstab-setup-with-network@<POOL_UUID>.service,x-systemd.after=stratis-fstab-setup-with-network@<POOL_UUID>.service 0 2`

If a filesystem's pool does not require that the network is up to be
unlocked then the fstab entry may use the existing
`stratis-fstab-setup@.service` unit instead.

`stratisd 3.8.1` also contains some minor fixes: it adds a previously
omitted D-Bus `PropertiesChanged` signal for the revision 8 `MergeScheduled`
property, includes additional information about stopped pools in the
D-Bus `StoppedPools` property, and improves some error messages.

<!-- more -->

Please consult the [stratisd] and [stratis-cli] changelogs for additional
information about the release.

[stratisd]: https://github.com/stratis-storage/stratisd/blob/master/CHANGES.txt
[stratis-cli]: https://github.com/stratis-storage/stratis-cli/blob/master/CHANGES.txt
0