diff --git a/content/SCALE/GettingStarted/Migrate/MigrateCOREHAtoSCALEHA.md b/content/SCALE/GettingStarted/Migrate/MigrateCOREHAtoSCALEHA.md index 15aac5ddfe..2af87c31a4 100644 --- a/content/SCALE/GettingStarted/Migrate/MigrateCOREHAtoSCALEHA.md +++ b/content/SCALE/GettingStarted/Migrate/MigrateCOREHAtoSCALEHA.md @@ -1,6 +1,6 @@ --- -title: "Enterprise HA Migrations" -description: "Discusses migrating a TrueNAS High Availability (HA) system from FreeBSD- to Linux-based TrueNAS software." +title: "Enterprise Migrations" +description: "Instructions for TrueNAS Enterprise users to migrate from FreeBSD- to Linux-based TrueNAS software." weight: 25 aliases: tags: @@ -11,6 +11,7 @@ keywords: - enterprise data storage solution - data migration - nas data storage +slug: migrate-enterprise --- **TrueNAS Enterprise customers should consult with iXsystems Support before attempting to migrate.** diff --git a/content/SCALE/GettingStarted/Migrate/MigratingFromCORE.md b/content/SCALE/GettingStarted/Migrate/MigratingFromCORE.md index c05ec0fc8e..705b833cf9 100644 --- a/content/SCALE/GettingStarted/Migrate/MigratingFromCORE.md +++ b/content/SCALE/GettingStarted/Migrate/MigratingFromCORE.md @@ -1,6 +1,6 @@ --- -title: "Migrating TrueNAS" -description: "Provides instructions on migrating from FreeBSD- to Linux-based TrueNAS versions. Migration methods include using an ISO or manual update file." +title: "Community Migrations" +description: "Provides instructions for TrueNAS community users to migrate from FreeBSD- to Linux-based TrueNAS versions. Migration methods include using an ISO or manual update file." weight: 15 aliases: - /scale/gettingstarted/migratingfromcore/ @@ -13,6 +13,7 @@ keywords: - nas data storage - RAIDz - spinning disk +slug: migrate-community --- ## Migration Overview diff --git a/content/SCALE/GettingStarted/Migrate/_index.md b/content/SCALE/GettingStarted/Migrate/_index.md index 6d8d388cca..47fd268abb 100644 --- a/content/SCALE/GettingStarted/Migrate/_index.md +++ b/content/SCALE/GettingStarted/Migrate/_index.md @@ -1,6 +1,6 @@ --- -title: "TrueNAS Migrations" -description: "Instructions for migrating from FreeBSD to Linux-based TrueNAS versions." +title: "Migrating from CORE" +description: "Instructions for migrating from FreeBSD TrueNAS CORE to Linux-based TrueNAS versions." geekdocCollapseSection: true weight: 40 aliases: @@ -20,7 +20,19 @@ keywords: - data migration --- +On March 20, 2024, iXsystems [announced](https://www.truenas.com/blog/truenas-core-13-3-plans/) that the FreeBSD-based TrueNAS CORE platform has entered "sustaining engineering phase within the TrueNAS project." +With this transition, TrueNAS 13.0 and 13.3 continue to receive bug fixes related to stability and security. +New feature development and component improvement continues on Linux-based TrueNAS versions. + +Existing TrueNAS 13.0 and 13.3 users who are comfortable with their TrueNAS system can remain on that major version. +Users looking for new feature development can sidegrade to the Linux-based TrueNAS platform at any time, preserving data and essential NAS functionality. {{< include file="/static/includes/MigrateCOREtoSCALE24_04.md" >}} +
diff --git a/content/SCALE/GettingStarted/SCALEReleaseNotes.md b/content/SCALE/GettingStarted/SCALEReleaseNotes.md index b37fc63a2b..775a0960c8 100644 --- a/content/SCALE/GettingStarted/SCALEReleaseNotes.md +++ b/content/SCALE/GettingStarted/SCALEReleaseNotes.md @@ -16,13 +16,21 @@ related: false {{< hint type="tip" title="25.04 Nightly Development Documentation" >}} This page tracks the latest development roadmap and notes for the future TrueNAS major version 25.04 (Fangtooth). -See the stable [24.04 (Dragonfish)](https://www.truenas.com/docs/scale/24.04/gettingstarted/scalereleasenotes/) or early development [24.10 (Electric Eel)](https://www.truenas.com/docs/scale/24.10/gettingstarted/scalereleasenotes/) release notes for information relating to that version. +See the stable [24.10 (Electric Eel)](https://www.truenas.com/docs/scale/24.10/gettingstarted/scalereleasenotes/) release notes for information relating to that version. {{< /hint >}} ## Features {{< include file="/static/includes/25.04FeatureList.md" >}} +## Obtaining a Release + +{{< include file="/static/includes/EarlyReleaseWarning.md" >}} + +For adventurous users that want to experiment with the latest feature development, 25.04 (Fangtooth) nightly images are available from the [the TrueNAS downloads server](https://download.truenas.com/truenas-scale-fangtooth-nightly/). + +More details are available from [Software Releases]({{< relref "/TrueNASUpgrades/_index.md" >}}). + ## Release Schedule {{< include file="/static/includes/ReleaseScheduleWarning.md" >}} @@ -34,23 +42,6 @@ See the stable [24.04 (Dragonfish)](https://www.truenas.com/docs/scale/24.04/get {{< include file="/static/includes/SoftwareStatusPage.md" >}} {{< /expand >}} -## 25.04 Nightly Development Changelog - -Coming soon - -{{< include file="/static/includes/RESTAPIDeprecationNotice.md" >}} - - -Update the system to the latest maintenance release of the installed major version before attempting to upgrade to a new TrueNAS major version. - -include file="/static/includes/SCALEUpgradePaths.md" +{{< include file="/static/includes/SCALEUpgradePaths.md" >}} -### TrueNAS Migrations + ## Component Versions Click the component version number to see the latest release notes for that component. @@ -97,8 +94,9 @@ Click the component version number to see the latest release notes for that comp {{< truetable >}} | Component | Version | |-----------|-------------| -| Linux Kernel | [_._.__](https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tag/?h=v_._.__) | -| OpenZFS | [_._.__](https://github.com/openzfs/zfs/tree/zfs-_._.__) | +| Linux Kernel | [6.12](https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tag/?h=v6.12) | +| OpenZFS | [2.3.0-2](https://github.com/openzfs/zfs/tree/zfs-2.3.0-rc3) | +| Docker Engine | [27.3.1](https://docs.docker.com/engine/release-notes/27/#2731) | {{< /truetable >}} ### OpenZFS Feature Flags @@ -108,12 +106,21 @@ Any new feature flags introduced since the previous OpenZFS version that was int {{< truetable >}} | Feature Flag | GUID | Notes | |--------------|------|-------| -| | [org.openzfs:raidz_expansion](https://openzfs.github.io/openzfs-docs/man/master/7/zpool-features.7.html#raidz_expansion) | | -| | [com.delphix:redaction_list_spill](https://openzfs.github.io/openzfs-docs/man/master/7/zpool-features.7.html#redaction_list_spill) | | +| fast deduplication | [com.klarasystems:fast_dedup](https://openzfs.github.io/openzfs-docs/man/master/7/zpool-features.7.html#fast_dedup) | This flag is present in 24.10, but is now generally available through the TrueNAS UI. | {{< /truetable >}} For more details on feature flags, see [OpenZFS Feature Flags](https://openzfs.github.io/openzfs-docs/Basic%20Concepts/Feature%20Flags.html) and [OpenZFS zpool-feature.7](https://openzfs.github.io/openzfs-docs/man/7/zpool-features.7.html). +## 25.04 Nightly Development Changelog + +* The TrueNAS REST API is deprecated in TrueNAS 25.04 and replaced by the [TrueNAS websocket client](https://github.com/truenas/api_client). Full removal of the REST API is planned for a future release. +* The default libvirt account UID & GID is changed to a less common value to avoid clashing with user created UID/GIDs. See Upgrade Notes above for more information ([NAS-131695](https://ixsystems.atlassian.net/browse/NAS-131695)). +* Improved API key mechanism with support for user-linked API keys ([NAS-131396](https://ixsystems.atlassian.net/browse/NAS-131396)). + Existing API keys created via the TrueNAS API (not UI or TrueCommand) that specify an allow list with white-listed API methods are revoked upon upgrade because there is no clean way to migrate to the new system. + Legacy API keys from TrueNAS 24.10 or earlier migrate to the root, admin, or truenas_admin account, depending on server configuration + + - \ No newline at end of file diff --git a/static/includes/MigrateCOREtoSCALE24_04.md b/static/includes/MigrateCOREtoSCALE24_04.md index b1c6b5d702..f0cecf8ad9 100644 --- a/static/includes/MigrateCOREtoSCALE24_04.md +++ b/static/includes/MigrateCOREtoSCALE24_04.md @@ -1,6 +1,6 @@ 
 -TrueNAS users wanting to migrate from 13.0-U6 (latest) or 13.3 to TrueNAS 24.10 or later can migrate to 24.04 and earlier using the UI, but must clean install if migrating to later releases. -Attempting to migrate directly to 24.10 or later releases fail and cannot be done. +TrueNAS users wanting to migrate from the latest FreeBSD-based 13.0-U6 or 13.3 CORE release to the Linux-based TrueNAS version 24.10 or later can migrate to 24.04 and earlier using the UI, but must clean install if migrating to later releases. +Attempting to migrate directly to 24.10 or later releases using the UI is not supported. -Download a copy of the