24.04 (Dragonfish) Version Notes

13 minute read.

Last Modified 2024-04-25 09:03 EDT

24.04 Dragonfish

Primary Features

There are many new features and continued improvements to the TrueNAS SCALE experience:

New SMB and NFS status pages for active session monitoring and administration.
New Auditing feature! Administrators can keep and view audit logs about SMB clients and other TrueNAS UI authorization and account activity.
New support for FreeIPA configurations is added to the LDAP credentials fields!
New Community feature: SCALE Sandboxes provide a similar functionality to TrueNAS CORE jails or Linux LXC containers.
New Community feature: unsupported Developer mode for customizing TrueNAS.
New Dashboard widget for monitoring and quick creation of data backup tasks.
Exposed Netdata UI under Reporting > Netdata for deeper real-time introspection and reporting on system performance.

Reworked Share creation forms for a faster and smoother experience.
Reworked Cloud backup form to improve the user experience.
Expanded feedback system for rating UI screens and creating TrueNAS project bug reports or improvement suggestions.
ZFS ARC memory allocations are updated and behave identically to TrueNAS CORE.
New privilege levels for TrueNAS administrative users for greater system security hardening.
Linux kernel and NVIDIA driver updates.
Improved performance for SMB Shares with directories containing large file counts.
Third-Party SMB Data Migration from external sources.

Obtaining a Release

24.04 (Dragonfish) is available from the TrueNAS SCALE download page.

For adventurous users that want to experiment with the latest developments, nightly build .iso and .update files are also available.

More details are available from Software Releases.

Release Schedule

The release names and dates provided here are tentative and can change at any time.

SCALE™ | Enterprise™

Current

TrueNAS SCALE 24.10 - Electric Eel

Latest:

24.10 Nightlies Experimental 23 January 2024

Anticipated:

24.10-BETA.1 Early

24.10-RC.1 Early

24.10.0 Stable

Software Lifecycle

TrueNAS Quality Lifecycle

TrueNAS releases follow a general adoption guideline for their lifetime.

Starting with the NIGHTLY builds, each stage of a major release incorporates more testing cycles and bug fixes that represent a maturation of the release. With each version release stage, users are encouraged to install, upgrade, or otherwise begin using the major version, depending on the specific TrueNAS deployment and use case:

Release Stage	Completed QA Cycles	Typical Use	Description
NIGHTLY	0	Developers	Incomplete
ALPHA	1	Testers	Not much field testing
BETA	2	Enthusiasts	Major Feature Complete, but expect some bugs
RC	4	Home Users	Suitable for non-critical deployments
RELEASE	6	General Use	Suitable for less complex deployments
U1	7	Business Use	Suitable for more complex deployments
U2+	8	Larger Systems	Suitable for higher uptime deployments

The Software Status page shows the latest recommendations for using the various TrueNAS software releases.

Upgrade Notes

An issue was discovered after 24.04.0 released where a TrueNAS system that has a VM configured with IPv6 bind addresses can disrupt the TrueNAS web interface after upgrading to 24.04.0 (NAS-128102). Users with this particular configuration are encouraged to either wait for the 24.04.1 maintenance release before upgrading or remove any IPv6 bind addresses from existing VMs before upgrading to 24.04.0.

After updating, clear the browser cache (CTRL+F5) before logging in to SCALE. This ensures stale data doesn’t interfere with loading the SCALE UI.

TrueNAS SCALE is an appliance built from specific Linux packages. Attempting to update SCALE with apt or methods other than the SCALE web interface can result in a nonfunctional system.
Users with unofficial apps installed should review app storage drivers to determine if any utilize the OpenEBS-ZFS container storage interface (CSI) before upgrading. This CSI is not supported in TrueNAS SCALE 24.04 (Removal Notice). Unofficial apps which use OpenEBS-ZFS CSI drivers should maintain functionality for existing deployments, but users are not able to make backups or restore any existing backup for those apps. New users are not able to install and deploy these apps.
All auxiliary parameters can change between TrueNAS major versions due to security and development changes. We recommend removing all auxiliary parameters from TrueNAS configurations before upgrading.
TrueNAS SCALE 24.04 (Dragonfish) no longer includes the deprecated gluster component. Systems installed with 24.04 cannot be used in experimental TrueCommand clusters. Community users that experimented with this now-deprecated TrueCommand feature need to migrate any data from the TrueCommand cluster and delete it before upgrading any clustered SCALE systems to 24.04.
Several built-in services from SCALE 22.12 (Bluefin) in System Settings > Services are replaced by community applications (details). SCALE 22.12 (Bluefin) systems must disable these built-in services and begin using the equivalent application before upgrading to SCALE 23.10 (Cobia), prior to upgrading to SCALE 24.04, or users can force an upgrade without disabling them. This is not recommended for the S3 service as you must migrate the MinIO service and data or lose it.
SCALE 24.04 changes the default user home directory location from /nonexistent to /var/empty. This new directory is an immutable directory shared by service accounts and accounts that should not have a full home directory.
Services impacted:
- SMB if a home share is enabled
- SSH
- Shell access (edited)
See Managing Users for more information.
Users upgrading from TrueNAS SCALE 23.10 (Cobia) to 24.04 (Dragonfish) who import a Cobia configuration file might find that some services are not automatically enabled as expected. After uploading the configuration file and rebooting the system, review System Settings > Services. For services any that should be enabled, set it to Running and Start Automatically.

Upgrade Paths

There are a variety of options for upgrading to SCALE 24.04.

With a stable release, upgrading to SCALE 24.04 (Dragonfish) from an earlier SCALE release is primarily done through the web interface update process. Another upgrade option is to use a SCALE .iso file to perform a fresh install on the system and then restore a system configuration file.

See the TrueNAS Software Status page for recommendations about which software version to use based on your user type.

Update the system to the latest maintenance release of the installed major version before attempting to upgrade to a new TrueNAS SCALE major version.

TrueNAS SCALE

flowchart LR

A["22.02.4 (Angelfish)"] -->|update| C
B[CORE 13.0-U6.1] -->|ISO install| E
C["22.12.4.2 (Bluefin)"] -->|update| D
D["23.10.2 (Cobia)"] -->|update| E
E["24.04.0 (Dragonfish)"]

TrueNAS SCALE Enterprise

flowchart LR
A["CORE 13.0-U6.1"] -->|ISO install| D
B["Current 23.10 (Cobia) release"] -->|update| C["23.10.2 (Cobia)"] -->|update| D["24.04.0 (Dragonfish)"]

CORE > SCALE Migrations

Migrating TrueNAS from CORE to SCALE is a one-way operation. Attempting to activate or roll back to a CORE boot environment can break the system.
Upgrade your CORE system to the latest publicly-available 13.0-U6.1 (or later) release before attempting to migrate from CORE to SCALE.

TrueNAS Enterprise
Enterprise customers with HA systems should contact iXsystems Support for assistance with migrating to TrueNAS SCALE.
iXsystems Support
Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.
Contact Method Contact Options
Web https://support.ixsystems.com
Email support@ixsystems.com
Telephone Monday - Friday, 6:00AM to 6:00PM Pacific Standard Time:

US-only toll-free: 1-855-473-7449 option 2
Local and international: 1-408-943-4100 option 2
Telephone After Hours (24x7 Gold Level Support only):

US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
rates apply)

Contact Method	Contact Options
Web	https://support.ixsystems.com
Email	support@ixsystems.com
Telephone	Monday - Friday, 6:00AM to 6:00PM Pacific Standard Time: US-only toll-free: 1-855-473-7449 option 2 Local and international: 1-408-943-4100 option 2
Telephone	After Hours (24x7 Gold Level Support only): US-only toll-free: 1-855-499-5131 International: 1-408-878-3140 (international calling rates apply)

When attempting to migrate from TrueNAS CORE, the general recommendation is to back up the system configuration file and use a SCALE .iso file to fresh install TrueNAS. After install, restore the system configuration and import the pools.

Depending on the specific system configuration, this can be a straightforward or complicated process. See the Migration articles for cautions and notes about differences between each software and the CORE to SCALE migration process.

You must either clean install or use an upgrade *iso file to migrate a TrueNAS CORE system to SCALE 24.04 (Dragonfish). Enterprise customers should contact Support for assistance with transitioning from CORE to SCALE.

Component Versions

Click the component version number to see the latest release notes for that component.

Component	Version
Debian Base	12 (Bookworm)
Linux Kernel	6.6.20
NVIDIA Driver	545.23.08-2
OpenZFS	2.2.3-2

OpenZFS Feature Flags

24.04.0 (Dragonfish) has the same OpenZFS major version as 23.10.1 (Cobia).

The items listed here represent new feature flags implemented since the previous update to the built-in OpenZFS version (2.1.11).

Feature Flag	GUID	Notes
blake3	org.openzfs:blake3
block_cloning	com.fudosecurity:block_cloning
draid	org.openzfs:draid
head_errlog	com.delphix:head_errlog
vdev_zaps_v2	com.klarasystems:vdev_zaps_v2
zilsaxattr	org.openzfs:zilsaxattr

For more details on feature flags, see OpenZFS Feature Flags and OpenZFS zpool-feature.7.

24.04.0 Changelog

April 23, 2024

iXsystems is pleased to release TrueNAS SCALE 24.04.0! This is the first stable release of TrueNAS SCALE 24.04 Dragonfish. It includes numerous software component updates and polished features, as well as fixes for issues discovered in 24.04-RC.1.

Notable changes:

Users migrating data from an existing third-party NAS solution to TrueNAS SCALE 24.04 can use the Syncthing Enterprise application to mount the source with a remote SMB share that preserves metadata. See Third-Party SMB Data Migration for considerations and a full tutorial.
Improved workflow for FIPS changes on HA systems (NAS-128187).
Improved compatibility of TrueNAS SCALE MinIO app and CORE MinIO plugin facilitate simplified migration for CORE users with S3 data deployments.
Fixed bug to ensure ISCSI targets are mountable after removing and replacing targets (NAS-128099).
Bug fix for NUT service and UPS data reporting (NAS-127788).
Ensure Netdata reporting history persists after reboot (NAS-127880).
Hide SPICE viewer password when entered (NAS-127868).
Fixes for units and data display on the Dashboard and Reporting page (NAS-127963 and NAS-127854).
Update replication resume token at object receive instead of data receive (NAS-126772).
Relax L2ARC lock during write operations to prevent OOM activation or deadlock (NAS-127456).
Prevent Datasets tree from unexpectedly collapsing open datasets (NAS-127966).
Fix GPU endpoint usage for GPU passthrough (NAS-127882).
Prevent cloud sync tasks from failing when pre/post-init scripts are present (NAS-127975).
Fix regression in directory services initialization affecting SMB share ACLs (NAS-127970).

Click here for the full changelog of completed tickets that are included in the 24.04.0 release.

24.04.0 Known Issues

An issue was discovered after 24.04.0 released where a TrueNAS system that has a VM configured with IPv6 bind addresses can disrupt the TrueNAS web interface after upgrading to 24.04.0 (NAS-128102). Users with this particular configuration are encouraged to either wait for the 24.04.1 maintenance release before upgrading or remove any IPv6 bind addresses from existing VMs before upgrading to 24.04.0.
Installed Apps network traffic is reporting numbers greater than actual usage NAS-128471.

Click here to see the latest information about public issues discovered in 24.04.0 that are being resolved in a future TrueNAS SCALE release.

24.04-RC.1 Changelog

Click to Expand

Early releases are intended for testing and feedback purposes. Do not use early release software for critical tasks.

March 21, 2024

iXsystems is pleased to release TrueNAS SCALE 24.04-RC.1! This release candidate version has software component updates and new features that are in the polishing phase as well as fixes for issues discovered in 24.04-BETA.1.

Notable changes:

New privilege levels for TrueNAS administrative users for greater system security hardening (NAS-123416).
UPS graphs are added to Reporting screens (NAS-125159).
Fixes and polish on Dashboard and Reporting screens (NAS-125453, NAS-127824).
Fix for missing SATA/SSD temperatures (NAS-127524).
Prevent catalog validation from exhausting available space in /var/run (NAS-127213).
Fix for Autoextend fails when upgrading drives in vdev - manual extend causes drive to drop offline (NAS-126809).
Prevent SMB access-denied error when copying a read-only file with an alternate data stream (NAS-126846).
Ensure alert notifications expire properly (NAS-127543).
Improved zpool TRIM performance (NAS-125882).
Improved Kubernetes stability for applications (NAS-125640).
Exposed Netdata UI under Reporting > Netdata for deeper real-time introspection and reporting on system performance.
The Netdata UI bases time on the local browser time, while the SCALE Reporting screen is based on the TrueNAS system time. Some difference in event time between the two screens is expected.

Click here for the full changelog of completed tickets that are included in the 24.04-RC.1 release.

24.04-RC.1 Known Issues

Users upgrading from TrueNAS SCALE 23.10 (Cobia) to 24.04 (Dragonfish) who import a Cobia configuration file might find that some services are not automatically enabled as expected. After uploading the configuration file and rebooting the system, review System Settings > Services. For services any that should be enabled, set it to Running and Start Automatically.
System data reporting graphs on the Dashboard and Reporting screens are undergoing additional review and polish ahead of the 24.04.0 release.

Click here to see the latest information about public issues discovered in 24.04-RC.1 that are being resolved in a future TrueNAS SCALE release.

24.04-BETA.1 Changelog

Click to Expand

Early releases are intended for testing and feedback purposes. Do not use early release software for critical tasks.

February 6, 2024

iXsystems is pleased to release TrueNAS SCALE 24.04-BETA.1! This has software component updates and new features that are in the polishing phase.

Notable changes:

New audit logging framework added with initial support for SMB and other TrueNAS UI account and authorization activity (NAS-123447), including SMB activity (NAS-123371). An Auditing screen manages this feature in the UI.
New dashboard widget for backup configurations is available. This summarizes saved backup tasks and has links to quickly set up new backup schedules.
New status pages for SMB and NFS services allow managing active sessions (SMB - NAS-105505 and NFS - NAS-124942).
FreeIPA support is added to Credentials > Directory Services > Configure LDAP form (NAS-123701).
The Feedback reporting window has improved! The page rating icon is now always visible on the top toolbar and the feedback window also functions for new bug reports and improvement suggestions (NAS-124484). Clicking File a ticket on System Settings > General also opens the feedback window.
An unsupported development mode is added to the base system. Enabling this puts the system in an unsupported state and allows customization of the operating system.
systemd-nspawn containers (Sandboxes) are added as an unsupported community feature so that an advanced containerization user can deploy custom software in persistent containers.
Support is added for data ingest via filesystem (SMB/NFS) clients, allowing users migrating to TrueNAS SCALE to more easily import data from a third party NAS solution (NAS-123717). Supported SMB migration via the TrueNAS Syncthing Enterprise app is arriving in a future 24.04 release.
Linux kernel is updated to 6.6 (NAS-123465).
ZFS ARC memory allocations are now identical to TrueNAS CORE (NAS-123034).
Share creation forms are reworked to centralize and speed up the configuration process (NAS-123420).
The feedback system is reworked and expanded to also control creating bug reports and improvement suggestions in the TrueNAS Jira project (NAS-124484).
The deprecated gluster component is removed and all other gluster-related components are removed from TrueNAS SCALE.
OpenEBS-ZFS container storage interface (CSI) driver support is removed in TrueNAS SCALE 24.04 (Removal Notice).
New and existing users who only use official apps are unaffected by this change, as these apps do not use OpenEBS-ZFS CSI drivers. Unofficial apps are unaffected if they are configured as outlined below.
Unofficial apps which use OpenEBS-ZFS CSI drivers should maintain functionality for existing deployments, but users are not able to make backups or restore any existing backup for those apps. New users are not able to install and deploy these apps.
Maintainers of unofficial catalog apps using OpenEBS-ZFS CSI drivers should either begin to ship a CSI driver with the app or use the one provided in SCALE.
Improved performance for SMB Shares with directories containing large file counts.

Click here for the full changelog of completed tickets that are included in the 24.04-BETA.1 release.

24.04-BETA.1 Known Issues

The administrator account privileges feature is still under development and further bugfixes and enhancements are anticipated in future 24.04 (Dragonfish) releases. Issues that are currently being resolved as part of finishing the feature:
- Read-only TrueNAS administrators are not able to query audit entries. This fix is anticipated in the 24.04-RC.1 release.
Displayed units for network traffic are inconsistent between the web interface Dashboard and Reporting screens. Additional changes for consistency and IEC conformant terminology is targeted for 24.04-RC.1 NAS-125453.

Click here to see the latest information about public issues discovered in 24.04-BETA.1 that are being resolved in a future TrueNAS SCALE release.