We are pleased to announce the general availability of FreeNAS 11.2-RELEASE. This release represents a significant development and testing effort. Existing users are encouraged to read these Release Notes thoroughly, including the Updating Recommendations section, before updating to become familiar with the potential impacts of the update. New users are encouraged to install this release in order to take advantage of the many improvements and bug fixes introduced in 11.2. As always, please report any bugs to https://redmine.ixsystems.com/projects/freenas/.
To update to this release, select the 11.2-STABLE train in System → Update. To install this release, refer to https://www.freenas.org/download/ for installation instructions and to download the installation file.
These major features are new in the 11.2 series:
While most updates “just work” it is possible that certain hardware or software configurations will experience issues. This section summarizes common issues and how to resolve them.
Before updating, save a copy of your configuration: System → General → Save Config. If you really care about your existing boot environments (many users don’t), replicate them to another system.
Resolving Boot Issues
While the new boot loader fixes boot issues for some hardware, it may result in boot issues for other hardware. If the updated system does not boot, do not panic as your data is still intact. To resolve:
Upgrading the Storage Pools
After the update, you may receive an alert indicating “New feature flags are available”. The User Guide explicitly states a number of caveats to consider before updating an existing pool to the latest feature flags. To put this into perspective, ask yourself the following questions before updating the pool:
Until you are sure that the answer to both questions is “no”, ignore (or dismiss) the alert and do not update the pool.
Updating Existing Jails or Plugins
Existing warden (legacy) plugins and jails must be managed while logged into the legacy UI. Since warden plugins/jails are now deprecated, the install and update functions have been disabled in the legacy UI. However, you can continue to start and stop plugins/jails, access their shell, and manage their mount points.
Warden (legacy) jails/plugins created in earlier versions and iocage (new) jails/plugins created in 11.2 can coexist and FreeNAS supports running multiple versions of the same plugins. This allows users to continue to use legacy plugins/jails until they have the opportunity to install and test replacements for their legacy versions using the new UI.
While a migration script is available, no script can account for every possible software configuration. If you decide to try the script, bear in mind that you will want to thoroughly test the functionality of the migrated plugin/jail before deleting the original plugin/jail. The recommended method is to reinstall plugins/jails from scratch using the new UI, copy or recreate any plugins/jails configurations, test that the new plugins/jails work as expected, and delete the legacy plugins/jails when everything is working as expected.
These plugins have been removed from the Plugins → Available listing of the new UI as they have failed qualification:
All other plugins have been tested as working,. Refer to 58482 for the RELEASE plugin versions, testing details, and associated tickets.
FreeNAS 11.2-RELEASE includes the Changelogs from the BETA and Release Candidate (RC) versions:
As well as these tickets:
27878 | Bug | Rework L2ARC encryption warning in User Guide |
41220 | Feature | Generate krb5.conf and keytab files using middleware |
53127 | Bug | Ensure Sonarr and Radarr permissions allow plugin to update |
54693 | Bug | Always free memory before swapping |
54879 | Bug | Improve wording of “Save Configuration” dialog in new UI |
55980 | Bug | Prevent setting record or block sizes below 4K and warn when changing record size |
56772 | Bug | Use inbuilt validator cron-parser for validating Cron Jobs and SMART Tests |
57021 | Bug | Update sysutils/uefi-edk2-bhyve to 0.2 |
57060 | Feature | Update RancherOS to 1.4.2 |
57105 | Bug | Add -d removable for all S.M.A.R.T. devices |
57429 | Bug | Fix typo in the Restart dialogue when updating |
57825 | Bug | Put anchors at end of generated URLs |
58086 | Bug | Fix incorrect wording in LDAP section of Guide |
58320 | Bug | Prevent changing an existing user’s UID in new UI |
58365 | Bug | Fallback to using the jail’s freebsd_version if RELEASE fails |
58407 | Bug | Clarify meaning of “redirect stdout/stderr” under Cron Jobs of new UI |
58434 | Bug | Use consistent bandwidth labels in Dashboard of new UI |
58455 | Bug | Rename BitTorrent Sync plugin to Resilio Sync |
58482 | Feature | Update iocage Plugins for 11.2-RELEASE |
58644 | Bug | Improve service_monitor handling for unrecoverable AD |
58653 | Bug | Fix kernel panic due to leak in physical memory accounting |
58662 | Bug | Fix creation of vlan parent interface when using netcli |
58767 | Bug | Initialize security for NFSv4 shares |
58788 | Bug | Validate AD config file before trying to configure Kerberos |
58833 | Bug | Overlay Zoneminder my.cnf file to allow cameras to be added |
59238 | Bug | Fix entity tree component |
59382 | Feature | General UI improvements for RELEASE |
59571 | Bug | Add support for Azure Blob storage |
59616 | Bug | Fix pool.import_disk rsync stderr being lost |
59985 | Bug | Fix multiple samba CVEs |
60279 | Bug | Fix FreeBSD-SA-18:13.nfs |
60927 | Bug | Fix multi-select bug in new UI |
61071 | Bug | Add post-install script for Zoneminder Plugin |
61254 | Bug | Remove pre-production warning for 11.2-RELEASE |
61137 | Bug | More form select fixes |