From d7df518f7f0578852c7302e59770378a8f86f52e Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 10:15:01 -0400 Subject: [PATCH 01/23] Create 13.3Overview.md --- static/includes/13.3Overview.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 static/includes/13.3Overview.md diff --git a/static/includes/13.3Overview.md b/static/includes/13.3Overview.md new file mode 100644 index 0000000000..379f6a630d --- /dev/null +++ b/static/includes/13.3Overview.md @@ -0,0 +1,15 @@ + + +TrueNAS CORE 13.3, the latest version of the most reliable and [highest-quality](https://www.truenas.com/blog/gartner-peer-insights-customer-choice-for-primary-storage-in-2024/) platform for traditional primary storage use cases continues to focus on ensuring storage reliability, stability, and security for existing users. + +With this release, TrueNAS CORE is now entering a sustaining engineering phase within the TrueNAS project. Users can expect to receive maintenance updates for many years still to come. See [TrueNAS CORE 13.3 Plans](https://forums.truenas.com/t/truenas-core-13-3-plans) for more information. + +TrueNAS CORE 13.3 will include the following updates: + +* [FreeBSD 13.3](https://www.freebsd.org/releases/13.3R/relnotes/) +* [OpenZFS 2.2.3](https://github.com/openzfs/zfs/releases/tag/zfs-2.2.3) +* [Samba 4.19](https://www.samba.org/samba/history/samba-4.19.0.html) +* Updates to SMART, Network UPS Tools (NUT), and other services +* Various security and bug fixes + +TrueNAS CORE 13.3 will continue to receive bug fixes related to stability and security. These updates will ensure that 13.3 is a reliable platform for both homelab and enterprise customers, as well as a staging version for those users who wish to [migrate to SCALE](https://www.truenas.com/docs/scale/gettingstarted/migrate/) at a later date. From b828716e1969f788904ebd5c384317264c2d7daa Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 10:15:05 -0400 Subject: [PATCH 02/23] Update _index.md --- content/_index.md | 48 +++++++++++++++-------------------------------- 1 file changed, 15 insertions(+), 33 deletions(-) diff --git a/content/_index.md b/content/_index.md index 27386e5d38..246c97326d 100644 --- a/content/_index.md +++ b/content/_index.md @@ -1,5 +1,5 @@ --- -title: "TrueNAS CORE" +title: "TrueNAS CORE 13.3" geekdocCollapseSection: true weight: 10 aliases: @@ -16,54 +16,36 @@ div.docs-read_mod {display: none;} h1 {display:none;} -{{< columns size="small" >}} -

-TNCORELogo -

-<---> -**TrueNAS CORE** is free and Open Source and is the successor to the wildly popular FreeNAS. -It runs on virtually any x86_64 system and provides a broad set of features for many users. -Plugin applications like Plex, NextCloud, and Asigra allow the functionality of a system to be customized for many use cases. -{{< /columns >}} +{{< header logo="/images/truenas-core-logo.png" logo_alt="TrueNAS CORE Logo" version="TrueNAS CORE 13.3" icon="" icon_alt="" >}} -
+{{< include file="/static/includes/13.3Overview.md" >}} -{{< columns size="small" >}} -

-TNCORELogo -

-<---> -**TrueNAS CORE Enterprise** is provided as part of an [iXsystems hardware](/hardware) purchase or extended iXsystems Support Contract. -Systems can have either single or dual controllers to enable High Availability (HA). -It can also be provided with Enterprise-grade support from iXsystems. -{{< /columns >}} - -## Nightly Development Featured Content +## TrueNAS CORE 13.3 Featured Content To view documentation for historical or the latest stable TrueNAS CORE major versions, use the **Version** dropdown at the top of this page.

Getting Started Guide -
Release Notes -
Community Hardware Guide -
Software Install +
Release Notes +
Community Hardware Guide +
Software Install

Tutorials -
Networking -
Storage -
Sharing +
Networking +
Storage +
Sharing

UI Reference Guide -
System -
Network -
Storage +
System +
Network +
Storage

Additional Content -
API Reference -
Security Reports +
API Reference +
Security Reports

From bec72c7ff01fb5340e9f9703b1091d50b5278c62 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 11:06:43 -0400 Subject: [PATCH 03/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 41 +++++++++++++--------- 1 file changed, 25 insertions(+), 16 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index 4452573996..4d72df88e2 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -1,26 +1,22 @@ --- -title: Nightly Version Notes -description: "Highlights and change log for the next major version of TrueNAS CORE." +title: 13.3 Version Notes +description: "Highlights and change log for each TrueNAS CORE 13.3 release." weight: 3 aliases: - - /releasenotes/core/13.0beta1/ - - /releasenotes/core/13.0rc1/ - - /core/13.0/gettingstarted/corereleasenotes/ - - /releasenotes/core/ - - /core/corereleasenotes/ - - /core/13.3/gettingstarted/corereleasenotes/ related: false --- -{{< header logo="/images/truenas-core-logo.png" logo_alt="TrueNAS CORE Logo" version="13.3" icon="" icon_alt="" >}} -{{< hint type="tip" >}} -This page is being rebuilt with notes from the latest TrueNAS CORE **nightly** development versions. -The latest [TrueNAS CORE **13.0** version release notes](https://www.truenas.com/docs/core/13.0/gettingstarted/corereleasenotes/) are now available from the TrueNAS CORE 13.0 documentation section. -Release notes for all the latest major versions are also linked from the [Docs Hub Home](/) +{{< header logo="/images/truenas-core-logo.png" logo_alt="TrueNAS CORE Logo" version="TrueNAS CORE 13.3" icon="" icon_alt="" >}} + +{{< hint type="tip" title="13.3 Early Release Documentation">}} +This page tracks the latest development roadmap and release notes for the next upcoming TrueNAS CORE major version, 13.3. +The latest [TrueNAS CORE **13.0** version release notes](https://www.truenas.com/docs/core/13.0/gettingstarted/corereleasenotes/) are available from the TrueNAS CORE 13.0 documentation section. {{< /hint >}} +{{< include file="/static/includes/13.3Overview.md" >}} + ## Obtaining a Release -{{< include file="archive/NightlyTestWarning.md" >}} +{{< include file="/static/includes/EarlyReleaseWarning.md" >}} To download a .tar file for installing or upgrading to a CORE 13.3 nightly version, go to https://www.truenas.com/download-truenas-core/ and click **Download Future Previews**. Select the latest .tar file and click **Download**. @@ -85,7 +81,14 @@ The items listed here represent new feature flags implemented since the previous 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). -## Nightly Changelog +## 13.3-BETA.1 Changelog + +{{< include file="/static/includes/EarlyReleaseWarning.md" >}} + +**May 7, 2024** + +iXsystems is pleased to release TrueNAS CORE 13.3-BETA.1! +This has software component updates and security fixes that are in the polishing phase. Notable changes: @@ -99,4 +102,10 @@ Notable changes: * The Plugins, Jails, and Virtual Machines features are in maintenance mode and are offered to the TrueNAS community "as-is". [TrueNAS Enterprise](https://www.truenas.com/truenas-enterprise/) customers with a critical need for virtualization features should consider TrueNAS SCALE for officially tested and supported virtualization features. - \ No newline at end of file + +Click here for the full changelog of completed tickets that are included in the 13.3-BETA.1 release. +{{< include file="/static/includes/JiraFilterInstructions.md" >}} + +### 13.3-BETA.1 Ongoing Issues + +Click here to see the latest information about public issues discovered in 13.3-BETA.1 that are either being resolved in a future TrueNAS CORE release or are not to be fixed in CORE and are resolved in TrueNAS SCALE. From 2f4d1801aba693aa92e384d8465b246cd9543e71 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 11:06:45 -0400 Subject: [PATCH 04/23] Update 13.3Overview.md --- static/includes/13.3Overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/static/includes/13.3Overview.md b/static/includes/13.3Overview.md index 379f6a630d..89abdf98e6 100644 --- a/static/includes/13.3Overview.md +++ b/static/includes/13.3Overview.md @@ -1,6 +1,6 @@ -TrueNAS CORE 13.3, the latest version of the most reliable and [highest-quality](https://www.truenas.com/blog/gartner-peer-insights-customer-choice-for-primary-storage-in-2024/) platform for traditional primary storage use cases continues to focus on ensuring storage reliability, stability, and security for existing users. +TrueNAS CORE 13.3, the latest version of the most reliable and [highest-quality](https://www.truenas.com/blog/gartner-peer-insights-customer-choice-for-primary-storage-in-2024/) platform for traditional primary storage use cases, continues to focus on ensuring storage reliability, stability, and security for existing users. With this release, TrueNAS CORE is now entering a sustaining engineering phase within the TrueNAS project. Users can expect to receive maintenance updates for many years still to come. See [TrueNAS CORE 13.3 Plans](https://forums.truenas.com/t/truenas-core-13-3-plans) for more information. From e91a65bbec2bfd78ba3f18ad192a39078bee3f8b Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 11:06:48 -0400 Subject: [PATCH 05/23] Create EarlyReleaseWarning.md --- static/includes/EarlyReleaseWarning.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 static/includes/EarlyReleaseWarning.md diff --git a/static/includes/EarlyReleaseWarning.md b/static/includes/EarlyReleaseWarning.md new file mode 100644 index 0000000000..644d45c228 --- /dev/null +++ b/static/includes/EarlyReleaseWarning.md @@ -0,0 +1,6 @@ + + +{{< hint type=warning title="Early Release Software" >}} +Early releases are intended for testing and feedback purposes. +Do not use early release software for critical tasks. +{{< /hint >}} From 3d92cabfb34aa8c00432c17c67f63b29b9586d4e Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 12:23:13 -0400 Subject: [PATCH 06/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index 4d72df88e2..6e37f9956e 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -92,7 +92,7 @@ This has software component updates and security fixes that are in the polishing Notable changes: -* Due to security vulnerabilities and maintainability issues, the S3 service is deprecated in TrueNAS CORE 13.0 and scheduled for removal in CORE 13.3. +* Due to security vulnerabilities and maintainability issues, the S3 service is deprecated in TrueNAS CORE 13.0 and removed in CORE 13.3 ([NAS-127694](https://ixsystems.atlassian.net/browse/NAS-127694)). Beginning in CORE 13.0-U6, the CORE web interface generates an alert when the deprecated service is either actively running or is enabled to start on boot. Users should migrate to a separately maintained [MinIO plugin]({{< relref "MinIOPlugin.md" >}}) or otherwise move any production data away from the S3 service storage location before upgrading to a 13.3 pre-release version. See the CORE 13.0 tutorial for [detailed migration instructions](http://www.truenas.com/docs/core/13.0/coretutorials/jailspluginsvms/plugins/minioplugin/). @@ -100,8 +100,18 @@ Notable changes: * The web UI **Shell** is removed in CORE 13.3. Users can continue to access the shell using [SSH]({{< relref "ConfiguringSSH.md" >}}) or a physical system connection with serial cable or other direct method ([NAS-124392](https://ixsystems.atlassian.net/browse/NAS-124392)). -* The Plugins, Jails, and Virtual Machines features are in maintenance mode and are offered to the TrueNAS community "as-is". - [TrueNAS Enterprise](https://www.truenas.com/truenas-enterprise/) customers with a critical need for virtualization features should consider TrueNAS SCALE for officially tested and supported virtualization features. +* The Plugins, Jails, and Virtual Machines features are untested and provided without support to the TrueNAS Community. + Users with a critical need to use containers or virtualization solutions in production should migrate to the tested and supported virtualization features available in [TrueNAS SCALE](https://www.truenas.com/download-truenas-scale/). + [TrueNAS Enterprise customers](https://www.truenas.com/truenas-enterprise/) can contact iXsystems to schedule a TrueNAS SCALE deployment. + See [CORE to SCALE Migrations](https://www.truenas.com/docs/scale/gettingstarted/migrate/) for more information. + +* Update SAMBA to version 4.19 ([NAS-120600](https://ixsystems.atlassian.net/browse/NAS-120600)). +* Update rsync to version 3.2.7 ([NAS-124036](https://ixsystems.atlassian.net/browse/NAS-124036)). +* Fix macOS Time Machine backup and snapshot issues ([NAS-125197](https://ixsystems.atlassian.net/browse/NAS-125197) and [NAS-125218](https://ixsystems.atlassian.net/browse/NAS-125218)). +* Bugfix for zettarepl memory leak ([NAS-125338](https://ixsystems.atlassian.net/browse/NAS-125338)). +* Allow ampersand (&) character in user email addresses ([NAS-125483](https://ixsystems.atlassian.net/browse/NAS-125483)). +* SNMP agent bugfix ([NAS-125904](https://ixsystems.atlassian.net/browse/NAS-125904)). +* Pagination offset and limit improvements for /api/v2.0/certificate ([NAS-126080](https://ixsystems.atlassian.net/browse/NAS-126080)). Click here for the full changelog of completed tickets that are included in the 13.3-BETA.1 release. {{< include file="/static/includes/JiraFilterInstructions.md" >}} From db33a856fb213d3b7155fe429a156d1bca4d44a6 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 14:59:27 -0400 Subject: [PATCH 07/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index 6e37f9956e..63af2dbd1e 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -52,18 +52,12 @@ More details are available from [Updating Core]({{< relref "updatingcore.md" >}} Click the component version number to see the latest release notes for that component. - - - - - - - - - - - -
ComponentVersion
FreeBSD13.2-RELEASE-p6
OpenZFS2.2.2-1
+{{< truetable >}} +| Component | Version | +|-----------|-------------| +| FreeBSD | [13.3-RELEASE-1](https://www.freebsd.org/releases/13.3R/relnotes/) | +| OpenZFS | [2.2.3-1](https://github.com/openzfs/zfs/releases/tag/zfs-2.2.3) | +{{< /truetable >}} ### New OpenZFS Feature Flags The items listed here represent new feature flags implemented since the previous update to the built-in OpenZFS version. From e2927ed20ecb6b9d2864724059654e292e6cc23a Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 29 Apr 2024 16:31:52 -0400 Subject: [PATCH 08/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 25 ++++++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index 63af2dbd1e..6e75d1e5df 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -43,11 +43,32 @@ More details are available from [Updating Core]({{< relref "updatingcore.md" >}} {{< releaselist name=core-releases defaultTab=3 >}} {{< /expand >}} - + +**TrueNAS CORE** + +{{< mermaid class="mermaid_sizing" >}} +flowchart LR + +A["11.0-U7"] -->|update| B["11.2-U8"] +B -->|update| C["11.3-U5"] +C -->|update| D["13.0-U6.1"] +D -->|"(anticipated)"| E["13.3.0"] +{{< /mermaid >}} + +**TrueNAS CORE Enterprise** + +{{< mermaid class="mermaid_sizing" >}} +flowchart LR + +A["11.0-U7"] -->|update| B["11.2-U8"] +B -->|update| C["11.3-U5"] +C -->|update| D["13.0-U6.1"] +{{< /mermaid >}} + ## Component Versions Click the component version number to see the latest release notes for that component. From f268b17a9bcb401caab226fedddee841a9921e7c Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 09:20:18 -0400 Subject: [PATCH 09/23] Update core-releases.yaml --- data/properties/core-releases.yaml | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/data/properties/core-releases.yaml b/data/properties/core-releases.yaml index 93f2f7c181..cd70b70f3e 100644 --- a/data/properties/core-releases.yaml +++ b/data/properties/core-releases.yaml @@ -5,13 +5,13 @@ product: "TrueNAS CORE" title: "CORE™ | Enterprise™" majorVersions: - lifecycle: "Previous" - name: "TrueNAS CORE 12.0" - releaseName: "12.0" + name: "TrueNAS CORE 11.3" + releaseName: "11.3" releases: - - name: "12.0-U2" + - name: "11.3-U5" type: "Maintenance" - link: "https://www.truenas.com/docs/files/CORE12.0Docs.pdf" - releaseDate: "2021-02-09" + link: "https://www.truenas.com/docs/_archive/corereleasenotes/freenas/11.3/11.3u5/" + releaseDate: "2020-09-29" latest: true - lifecycle: "Current" name: "TrueNAS CORE 13.0" @@ -26,11 +26,16 @@ majorVersions: name: "TrueNAS CORE 13.3" releaseName: "13.3" releases: + - name: "13.3-RC.1" + type: "Early" + link: "https://www.truenas.com/docs/core/13.3/gettingstarted/corereleasenotes/#133-beta1-changelog" + releaseDate: "2024-05-07" + latest: true - name: "13.3 Nightlies" type: "Experimental" link: "https://www.truenas.com/docs/core/13.3/gettingstarted/corereleasenotes/" releaseDate: "2024-01-01" - latest: true + latest: false - name: "13.3-RC.1" type: "Early" releaseDate: "2024-05-07" From e5d61a974a49eb8d2bb98ddd4f92caf2687b3847 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 09:20:20 -0400 Subject: [PATCH 10/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index 6e75d1e5df..e5c0677a10 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -5,7 +5,7 @@ weight: 3 aliases: related: false --- -{{< header logo="/images/truenas-core-logo.png" logo_alt="TrueNAS CORE Logo" version="TrueNAS CORE 13.3" icon="" icon_alt="" >}} +{{< header logo="/images/truenas-core-logo.png" logo_alt="TrueNAS CORE Logo" version="13.3" icon="" icon_alt="" >}} {{< hint type="tip" title="13.3 Early Release Documentation">}} This page tracks the latest development roadmap and release notes for the next upcoming TrueNAS CORE major version, 13.3. @@ -29,19 +29,15 @@ Click **APPLY UPDATE**. More details are available from [Updating Core]({{< relref "updatingcore.md" >}}). -{{< expand "Release Schedule (Click to expand)" "v" >}} - -## Software Lifecycle - -{{< include file="/static/includes/LifecycleTable.md" >}} - -{{< include file="/static/includes/SoftwareStatusPage.md" >}} - -## Schedule +## Release Schedule {{< include file="/static/includes/ReleaseScheduleWarning.md" >}} {{< releaselist name=core-releases defaultTab=3 >}} + +{{< expand "Software Lifecycle" "v" >}} +{{< include file="/static/includes/LifecycleTable.md" >}} +{{< include file="/static/includes/SoftwareStatusPage.md" >}} {{< /expand >}} ## Upgrade Notes From 210b65dcfef6b6611b4fcd30523f56e5c0167aa2 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 13:28:24 -0400 Subject: [PATCH 11/23] Update 13.3Overview.md --- static/includes/13.3Overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/static/includes/13.3Overview.md b/static/includes/13.3Overview.md index 89abdf98e6..f39c4850de 100644 --- a/static/includes/13.3Overview.md +++ b/static/includes/13.3Overview.md @@ -2,7 +2,7 @@ TrueNAS CORE 13.3, the latest version of the most reliable and [highest-quality](https://www.truenas.com/blog/gartner-peer-insights-customer-choice-for-primary-storage-in-2024/) platform for traditional primary storage use cases, continues to focus on ensuring storage reliability, stability, and security for existing users. -With this release, TrueNAS CORE is now entering a sustaining engineering phase within the TrueNAS project. Users can expect to receive maintenance updates for many years still to come. See [TrueNAS CORE 13.3 Plans](https://forums.truenas.com/t/truenas-core-13-3-plans) for more information. +With this release, TrueNAS CORE is now entering a sustaining engineering phase within the TrueNAS project. Users can expect to receive maintenance updates for many years still to come. TrueNAS CORE 13.3 will include the following updates: From 494157e39234f2f8ebe2b165efc036c43a838d43 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 13:54:26 -0400 Subject: [PATCH 12/23] Reorganize UpdatingTrueNAS --- .../UpdatingTrueNAS/UpdatingCORE.md | 155 ------------- .../UpdatingTrueNAS/UpdatingENTERPRISE.md | 4 +- .../UpdatingSoftwareforaMajorVersion.md | 121 ---------- .../CORETutorials/UpdatingTrueNAS/_index.md | 214 +++++++++++++++++- static/images/CORE/DownloadLatest.png | Bin 10405 -> 0 bytes 5 files changed, 213 insertions(+), 281 deletions(-) delete mode 100644 content/CORETutorials/UpdatingTrueNAS/UpdatingCORE.md delete mode 100644 content/CORETutorials/UpdatingTrueNAS/UpdatingSoftwareforaMajorVersion.md delete mode 100644 static/images/CORE/DownloadLatest.png diff --git a/content/CORETutorials/UpdatingTrueNAS/UpdatingCORE.md b/content/CORETutorials/UpdatingTrueNAS/UpdatingCORE.md deleted file mode 100644 index a3bb2dca2c..0000000000 --- a/content/CORETutorials/UpdatingTrueNAS/UpdatingCORE.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: "Updating CORE" -description: "Provides information on how to update TrueNAS CORE." -geekdocCollapseSection: true -weight: 10 -tags: -- configbackup -- update ---- - -TrueNAS CORE has an integrated update system to make it easy to keep up to date. - -## Prepare the System - -We recommend performing updates when the TrueNAS system is idle, with no clients connected and no scrubs or other disk activity happening. -Most updates require a system reboot. -Plan updates around scheduled maintenance times to avoid disrupting user activities. - -The update process does not proceed unless there is enough free space in the boot pool for the new update files. -If a space warning displays, go to **System > Boot** to remove unneeded boot environments. - -{{< expand "Updates and Trains" "v" >}} -TrueNAS uses cryptographically signed update files to update. -Update files provide flexibility in deciding when to upgrade the system. -TrueNAS installs updates in a new Boot Environment, allowing you to install and test an update, but revert to a previous Boot Environment in **System > Boot** if anything goes wrong. - -TrueNAS defines software branches known as trains. -We have several trains available for updates, but the web interface only displays trains you can select as an upgrade. - -Update trains have a numeric version followed by a short description. -The current version receives regular bug fixes and new features. -Supported older versions of TrueNAS only receive maintenance updates. -See the [Software Development Life Cycle]({{< relref "SofDevLifecycle.md" >}}) for more details about the development and support timeline for TrueNAS versions. - -We use three different terms to describe train types: - -**STABLE**: Bug fixes and new features are available from this train. Upgrades available from a STABLE train are tested and ready to apply to a production environment. - -**Nightlies**: Experimental train used for testing future versions of TrueNAS. - -**SDK**: Software Developer Kit train has additional tools for testing and debugging TrueNAS. - -{{< hint type=important >}} -The UI shows a warning when the selected train does not suit production use. -Before using a non-production train, be prepared to experience bugs or problems. -Testers are encouraged to submit bug reports at https://ixsystems.atlassian.net. -{{< /hint >}} -{{< /expand >}} - -### Check for Updates - -![System Update](/images/CORE/System/SystemUpdate.png "System Update") - -The system checks daily for updates and downloads an update if one is available. -An alert is issued when a new update becomes available. -The automatic check and download of updates are disabled by unsetting **Check for Updates Daily and Download if Available**. -Click (Refresh) to perform another check for updates. -To change the train, use the drop-down menu to make a different selection. - -{{< hint type=note >}} -The train selector does not allow downgrades. -For example, you cannot select the STABLE train while booted into a Nightly boot environment or a 9.10 train while booted into an 11 boot environment. -To go back to an earlier version after testing or running a more recent version, reboot and select a boot environment for that earlier version. -{{< /hint >}} - -Information about the update displays with a link to the release notes. -Alwys read the release notes before updating to determine if any of the changes in that release impact system use. - -### Save the Configuration File - -A dialog to save the system configuration file appears before installing updates. - -![Save Config](/images/CORE/System/SaveConfig.png "Save Config") - -{{< hint type=important >}} -Keep the system configuration file secure after saving it. -The security information in the configuration file can grant unauthorized access to your TrueNAS system. -{{< /hint >}} - -## Update the System - -Ensure the system is in a low-usage state as described above in [Preparing for Updates](#prepare-the-system). -Click **DOWNLOAD UPDATES** to download and install an update. - -The **Save Configuration** dialog appears so you can save the current configuration to external media. - -A confirmation window appears before installing the update. -If you set **Apply updates and reboot system after downloading**, clicking **CONTINUE** downloads and applies the update, then reboots the system. -The update can be downloaded for a later manual installation by unsetting **Apply updates and reboot system after downloading**. - -**APPLY PENDING UPDATE** displays when an update is downloaded and ready to install. -Setting **Confirm** and clicking **CONTINUE** updates and reboots the system. - -{{< hint type=important >}} -Each update creates a boot environment. -If the update process needs more space, it attempts to remove old boot environments. -TrueNAS does not remove boot environments marked with the *Keep* attribute as shown in **System > Boot**. -The upgrade fails if your system does not have space for a new boot environment. -Space on the operating system device can be manually freed by going to **System > Boot** and removing the *Keep* attribute or deleting any boot environments that are no longer needed. -{{< /hint >}} - -{{< expand "Can I force a full update?" "v" >}} -TrueNAS defaults to delta packages for updates. -While updating, TrueNAS only downloads files that changed in the base operating system since the previous update. -Delta update packages are more efficient than full update packages, providing a faster update and taking less bandwidth. -By contrast, a full update package downloads all the files included in the base system, even if those files have not changed. - -While the full package might require more time to install, there are some rare cases where it is necessary, such as when aplying a patch as a temporary fix to a local system. -A patch fixes a bug within the main codebase. -While software patches often fix bugs, they can also repair security issues or add new features. - -To force a full update, open the shell and enter this command: - -`freenas-update -C /tmp/update-$$ –no-delta –reboot update` - -The updater downloads the full package containing all the files from the latest software release. -When the download completes, the system reboots with the standard configuration. -{{< /expand >}} - -### Manual Updates - -You can manually download and apply updates in **System > Update**. - -{{< hint type=note >}} -You cannot use manual updates to upgrade from older major versions. -{{< /hint >}} - -Go to https://download.freenas.org/ and find an update file of the desired version. -Manual update file names end with manual-update.tar. - -Download the desired update file to your local system. -Log in to the TrueNAS web interface and go to **System > Update**. -Click **INSTALL MANUAL UPDATE FILE**. - -The **Save Configuration** dialog opens. -You can save a copy of the current configuration to external media for backup in case of an update problem. - -After the dialog closes, the manual update screen displays. - -The current version of TrueNAS displays for verification. - -![Update Manual](/images/CORE/System/UpdateManual.png "Manual Update") - -Select the manual update file saved to your local system using **Browse**. -Set **Reboot After Update** to reboot the system after the update installs. -Click **APPLY UPDATE** to begin the update. - -{{< hint type=important >}} -**Update in Progress** - -Starting an update shows a progress dialog. -When an update is in progress, the web interface shows an animated icon in the top row. -Dialogs also appear in every active web interface session to warn that a system update is in progress. -**Do not** interrupt a system update. -{{< /hint >}} diff --git a/content/CORETutorials/UpdatingTrueNAS/UpdatingENTERPRISE.md b/content/CORETutorials/UpdatingTrueNAS/UpdatingENTERPRISE.md index c4a48e350d..46e0fcc9e6 100644 --- a/content/CORETutorials/UpdatingTrueNAS/UpdatingENTERPRISE.md +++ b/content/CORETutorials/UpdatingTrueNAS/UpdatingENTERPRISE.md @@ -1,5 +1,5 @@ --- -title: "Updating CORE ENTERPRISE" +title: "Updating CORE Enterprise" description: "Describes how to update Enterprise-licensed TrueNAS CORE deployments." geekdocCollapseSection: true weight: 20 @@ -11,8 +11,6 @@ tags: This is Enterprise content that specifically applies to High Availability (HA) systems with a TrueNAS Enterprise license active. {{< /enterprise >}} - - Updating a TrueNAS Enterprise system configured for High Availability (HA) has a slightly different flow from non-HA systems or TrueNAS Core. The system downloads the update to both controllers, updates and reboots the standby TrueNAS controller, and finally fails over from and updates the active TrueNAS controller. diff --git a/content/CORETutorials/UpdatingTrueNAS/UpdatingSoftwareforaMajorVersion.md b/content/CORETutorials/UpdatingTrueNAS/UpdatingSoftwareforaMajorVersion.md deleted file mode 100644 index bf8f85ac9d..0000000000 --- a/content/CORETutorials/UpdatingTrueNAS/UpdatingSoftwareforaMajorVersion.md +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: "Updating Software for a Major Version" -description: "Describes options for keeping TrueNAS updated." -geekdocCollapseSection: true -weight: 30 -tags: -- update ---- - -TrueNAS provides flexibility for keeping the operating system up-to-date:
- -1. You can upgrade to major releases (ex. 9.3 to 9.10) using either an ISO or the web interface unless the Release Notes for the new major release indicate that the current version requires an ISO upgrade. -2. Minor releases are replaced with signed updates, meaning you do not need to wait for a minor release to update with a system update or newer versions of drivers and features. - It is also no longer necessary to manually download an upgrade file and its associated checksum to update the system. -3. The updater automatically creates a boot environment, making updates a low-risk operation. - Boot environments provide the option to return to the previous version of the operating system by rebooting the system and selecting the previous boot environment from the **System > Boot** menu. - -The [upgrade instructions](#upgrade-via-iso) instructions describe how to use an .iso file to perform a major version upgrade from an earlier version of FreeNAS/TrueNAS. -See the [Updating CORE]({{< relref "/CORETutorials/UpdatingTrueNAS/UpdatingCORE.md" >}}) or [Updating Enterprise]({{< relref "/CORETutorials/UpdatingTrueNAS/UpdatingENTERPRISE.md" >}}) articles for instructions about using the web interface to keep the system updated. - -The upgrade path for major versions of FreeNAS/TrueNAS is **9.3 > 9.10 > 11.1 > 11.3 > 12.0**. -We always recommend upgrading to a [supported version]({{< relref "SofDevLifecycle.md" >}}) of the software. - -## Caveats - -Be aware of these caveats before attempting a major version upgrade: - -* **Upgrading a data storage pool can make it impossible to go back to a previous version.** - For this reason, the update process does not automatically upgrade storage pools, though the system shows an alert when a pool is upgradable. - Unless new ZFS feature flags are needed, you can safely leave the pool at the current version. - If you upgrade the pool, you cannot boot into a previous TrueNAS version that does not support the newer feature flags. -* Upgrading the firmware of Broadcom SAS HBAs to the latest version is recommended. -* When upgrading from 9.3.x to 9.10, read this 9.3 to 9.10 FAQ first. -* **Upgrades from FreeNAS 0.7x are not supported.** - The system cannot import configuration settings from FreeNAS 0.7x versions. - You must manually recreate the configuration. - If supported, you must manually import the FreeNAS 0.7x pools or disks. -* **Upgrades on 32-bit hardware are not supported.** - However, if the system is currently running a 32-bit version of FreeNAS/TrueNAS and the hardware supports 64-bit, you can upgrade the system. - Any archived reporting graphs delete during upgrades. -* **UFS is not supported.** - If the data resides on one UFS-formatted disk, [create a ZFS pool]({{< relref "/CORETutorials/Storage/Pools/_index.md" >}}) using other disks after upgrading, then use the instructions in [Importing a Disk]({{< relref "ImportDisk.md" >}}) to mount the UFS-formatted disk and copy the data to the ZFS pool. - With only one disk, back up its data to another system or media before the upgrade, format the disk as `ZFS` after the upgrade, then restore the backup. - If the data resides on a UFS RAID of disks, you cannot directly import that data to the ZFS pool. - Instead, back up the data before the upgrade, create a ZFS pool after upgrading, then restore the data from the backup. -* **If you have GELI-encrypted pools and are upgrading to TrueNAS 12.0 or newer**, you might want to migrate data from the GELI-encrypted pools into ZFS-encrypted pools. - You CANNOT CONVERT the GELI pools. You must migrate the data to a new ZFS pool. - See the [Encryption article]({{< relref "StorageEncryption.md" >}}) for more details. - -## Prepare the System - -Before upgrading the operating system, follow these steps: - -1. Back up the TrueNAS configuration in **System > General > Save Config**. -2. Back up any encrypted data keys or passphrases and have them available. -3. Warn users that TrueNAS shared data is unavailable during the upgrade. - We recommend scheduling the upgrade for a time that will least impact users. -4. Stop all system **Services**. - -{{< hint type=important >}} -All auxiliary parameters are subject to change between major versions of TrueNAS due to security and development issues. We recommend removing all auxiliary parameters from TrueNAS configurations before upgrading. -{{< /hint >}} - -## Upgrade Via ISO - -To upgrade TrueNAS using an .iso file, go to https://www.truenas.com/download-truenas-core/ (TrueNAS CORE latest release) or https://download.freenas.org to download the .iso to the computer that prepares the installation media. -For example, this is the path to download an .iso of the latest FreeNAS 11.3 release: - -![DownloadLatest](/images/CORE/DownloadLatest.png "Path to latest 11.3 release") - -Burn the downloaded .iso file to a CD or USB stick. Refer to the [Prepare the Install File]({{< relref "/GettingStarted/Install.md#prepare-the-install-file" >}}) instructions in the Installation article for tips about burning the .iso to media using different Operating Systems. - -Insert the prepared media into the system and boot from it. -The installer waits ten seconds in the installer boot menu before booting the default option. -If needed, press Spacebar to stop the timer and choose another boot option. -After the media finishes booting into the installation menu, press Enter to select the default option `1 Install/Upgrade`. -The installer presents a screen showing all available drives. - -{{< hint type=important >}} -All drives display, including boot drives and storage drives. -Only choose boot drives when upgrading. -**Choosing the wrong drives to upgrade or install causes data loss.** -If you are unsure which drives contain the TrueNAS operating system, reboot and remove the install media. -Log in to the TrueNAS web interface and go to **System > Boot > ACTIONS > Boot Pool Status** to identify the boot drives. -More than one drive displays when using a mirror. -{{< /hint >}} - -Highlight the drive where TrueNAS is installed and press Spacebar to mark it with a star. -If using a mirror for the operating system, mark all the drives where the TrueNAS operating system is installed. -Press Enter when done. - -The installer recognizes earlier versions of FreeNAS/TrueNAS installed on the boot drives and asks to either upgrade or do a fresh install: - -![InstallerUpgradeChoice](/images/CORE/Install/InstallerUpgradeChoice.png "Upgrade Choice") - -To perform an upgrade, press Enter to accept the default Upgrade Install. -The installer displays another reminder that you should install the operating system on a disk you are not using for storage. - -![InstallerUpgradeMethod](/images/CORE/Install/InstallerUpgradeMethod.png "Upgrade Method") - -You can install the updated system in a new boot environment or format the entire operating system device to start fresh. -Installing into a new boot environment preserves the old code, allowing a roll-back to previous versions if necessary. -Formatting the boot device is usually not necessary but can reclaim space. -TrueNAS preserves user data and settings when installing in a new boot environment and formatting the operating system device. -Move the highlight to one of the options and press Enter to start the upgrade. - -The installer unpacks the new image and checks for upgrades to the existing database file. -The database file that is preserved and migrated contains your TrueNAS configuration settings. - -![Installer Upgrade Preserved Database](/images/CORE/Install/InstallerUpgradePreservedDatabase.png "Preserved Database") - -Press Enter. -TrueNAS indicates that the upgrade is complete and a reboot is required. -Press *OK*, highlight `3 Reboot System`, then press Enter to reboot the system. -If the upgrade installer was booted from CD, remove the CD. - -During reboot, the previous configuration database can convert to the new version. -The conversion happens during the reboot `Applying database schema changes` line. -The conversion can take a long time to finish, sometimes fifteen minutes or more, and can cause the system to reboot again. -The system boots normally afterwards. -If database errors display but the web interface is accessible, log in, go to **System > General**, and use the **UPLOAD CONFIG** button to upload the configuration backup you downloaded before starting the upgrade. diff --git a/content/CORETutorials/UpdatingTrueNAS/_index.md b/content/CORETutorials/UpdatingTrueNAS/_index.md index ac2bd7d0c0..763314c1f7 100644 --- a/content/CORETutorials/UpdatingTrueNAS/_index.md +++ b/content/CORETutorials/UpdatingTrueNAS/_index.md @@ -1,9 +1,219 @@ --- -title: "Updating TrueNAS" +title: "Updating CORE" description: "Tutorials for updating or upgrading a TrueNAS CORE system." geekdocCollapseSection: true weight: 900 related: false +tags: +- configbackup +- update +aliases: + - /coretutorials/updatingtruenas/updatingcore/ + - /coretutorials/updatingtruenas/updatingsoftwareforamajorversion/ --- -{{< children depth="2" description="true" >}} +TrueNAS CORE has an integrated update system to make it easy to keep up to date. + +{{< enterprise >}} +TrueNAS CORE Enterprise High Availability (HA) customers should see [Updating CORE Enterprise]({{< relref "/CORETutorials/UpdatingTrueNAS/UpdatingENTERPRISE.md" >}}) for additional considerations. +{{< /enterprise >}} + +## Prepare the System + +We recommend performing updates when the TrueNAS system is idle, with no clients connected and no scrubs or other disk activity happening. +Most updates require a system reboot. +Plan updates around scheduled maintenance times to avoid disrupting user activities. + +The update process does not proceed unless there is enough free space in the boot pool for the new update files. +If a space warning displays, go to **System > Boot** to remove unneeded boot environments. + +{{< expand "Updates and Trains" "v" >}} +TrueNAS uses cryptographically signed update files to update. +Update files provide flexibility in deciding when to upgrade the system. +TrueNAS installs updates in a new Boot Environment, allowing you to install and test an update, but revert to a previous Boot Environment in **System > Boot** if anything goes wrong. + +TrueNAS defines software branches known as trains. +We have several trains available for updates, but the web interface only displays trains you can select as an upgrade. + +Update trains have a numeric version followed by a short description. +The current version receives regular bug fixes and new features. +Supported older versions of TrueNAS only receive maintenance updates. +See the [Software Development Life Cycle]({{< relref "SofDevLifecycle.md" >}}) for more details about the development and support timeline for TrueNAS versions. + +We use three different terms to describe train types: + +**STABLE**: Bug fixes and new features are available from this train. Upgrades available from a STABLE train are tested and ready to apply to a production environment. + +**Nightlies**: Experimental train used for testing future versions of TrueNAS. + +**SDK**: Software Developer Kit train has additional tools for testing and debugging TrueNAS. + +{{< hint type=important >}} +The UI shows a warning when the selected train does not suit production use. +Before using a non-production train, be prepared to experience bugs or problems. +Testers are encouraged to submit bug reports at https://ixsystems.atlassian.net. +{{< /hint >}} +{{< /expand >}} + +### Check for Updates + +![System Update](/images/CORE/System/SystemUpdate.png "System Update") + +The system checks daily for updates and downloads an update if one is available. +An alert is issued when a new update becomes available. +The automatic check and download of updates are disabled by unsetting **Check for Updates Daily and Download if Available**. +Click (Refresh) to perform another check for updates. +To change the train, use the drop-down menu to make a different selection. + +{{< hint type=note >}} +The train selector does not allow downgrades. +For example, you cannot select the STABLE train while booted into a Nightly boot environment or a 9.10 train while booted into an 11 boot environment. +To go back to an earlier version after testing or running a more recent version, reboot and select a boot environment for that earlier version. +{{< /hint >}} + +Information about the update displays with a link to the release notes. +Alwys read the release notes before updating to determine if any of the changes in that release impact system use. + +### Save the Configuration File + +A dialog to save the system configuration file appears before installing updates. + +![Save Config](/images/CORE/System/SaveConfig.png "Save Config") + +{{< hint type=important >}} +Keep the system configuration file secure after saving it. +The security information in the configuration file can grant unauthorized access to your TrueNAS system. +{{< /hint >}} + +## Update the System + +Ensure the system is in a low-usage state as described above in [Preparing for Updates](#prepare-the-system). +Click **DOWNLOAD UPDATES** to download and install an update. + +The **Save Configuration** dialog appears so you can save the current configuration to external media. + +A confirmation window appears before installing the update. +If you set **Apply updates and reboot system after downloading**, clicking **CONTINUE** downloads and applies the update, then reboots the system. +The update can be downloaded for a later manual installation by unsetting **Apply updates and reboot system after downloading**. + +**APPLY PENDING UPDATE** displays when an update is downloaded and ready to install. +Setting **Confirm** and clicking **CONTINUE** updates and reboots the system. + +{{< hint type=important >}} +Each update creates a boot environment. +If the update process needs more space, it attempts to remove old boot environments. +TrueNAS does not remove boot environments marked with the *Keep* attribute as shown in **System > Boot**. +The upgrade fails if your system does not have space for a new boot environment. +Space on the operating system device can be manually freed by going to **System > Boot** and removing the *Keep* attribute or deleting any boot environments that are no longer needed. +{{< /hint >}} + +{{< expand "Can I force a full update?" "v" >}} +TrueNAS defaults to delta packages for updates. +While updating, TrueNAS only downloads files that changed in the base operating system since the previous update. +Delta update packages are more efficient than full update packages, providing a faster update and taking less bandwidth. +By contrast, a full update package downloads all the files included in the base system, even if those files have not changed. + +While the full package might require more time to install, there are some rare cases where it is necessary, such as when aplying a patch as a temporary fix to a local system. +A patch fixes a bug within the main codebase. +While software patches often fix bugs, they can also repair security issues or add new features. + +To force a full update, open the shell and enter this command: + +`freenas-update -C /tmp/update-$$ –no-delta –reboot update` + +The updater downloads the full package containing all the files from the latest software release. +When the download completes, the system reboots with the standard configuration. +{{< /expand >}} + +### Manual Updates + +You can manually download and apply updates in **System > Update**. + +{{< hint type=note >}} +You cannot use manual updates to upgrade from older major versions. +{{< /hint >}} + +Go to https://download.freenas.org/ and find an update file of the desired version. +Manual update file names end with manual-update.tar. + +Download the desired update file to your local system. +Log in to the TrueNAS web interface and go to **System > Update**. +Click **INSTALL MANUAL UPDATE FILE**. + +The **Save Configuration** dialog opens. +You can save a copy of the current configuration to external media for backup in case of an update problem. + +After the dialog closes, the manual update screen displays. + +The current version of TrueNAS displays for verification. + +![Update Manual](/images/CORE/System/UpdateManual.png "Manual Update") + +Select the manual update file saved to your local system using **Browse**. +Set **Reboot After Update** to reboot the system after the update installs. +Click **APPLY UPDATE** to begin the update. + +{{< hint type=important >}} +**Update in Progress** + +Starting an update shows a progress dialog. +When an update is in progress, the web interface shows an animated icon in the top row. +Dialogs also appear in every active web interface session to warn that a system update is in progress. +**Do not** interrupt a system update. +{{< /hint >}} + +## Upgrade Via ISO + +To upgrade TrueNAS to a new major version using an .iso file, use the [Release List](https://www.truenas.com/docs/truenasupgrades/) to download the .iso to the computer that prepares the installation media. + +Burn the downloaded .iso file to a CD or USB stick. Refer to the [Prepare the Install File]({{< relref "/GettingStarted/Install.md#prepare-the-install-file" >}}) instructions in the Installation article for tips about burning the .iso to media using different Operating Systems. + +Insert the prepared media into the system and boot from it. +The installer waits ten seconds in the installer boot menu before booting the default option. +If needed, press Spacebar to stop the timer and choose another boot option. +After the media finishes booting into the installation menu, press Enter to select the default option `1 Install/Upgrade`. +The installer presents a screen showing all available drives. + +{{< hint type=important >}} +All drives display, including boot drives and storage drives. +Only choose boot drives when upgrading. +**Choosing the wrong drives to upgrade or install causes data loss.** +If you are unsure which drives contain the TrueNAS operating system, reboot and remove the install media. +Log in to the TrueNAS web interface and go to **System > Boot > ACTIONS > Boot Pool Status** to identify the boot drives. +More than one drive displays when using a mirror. +{{< /hint >}} + +Highlight the drive where TrueNAS is installed and press Spacebar to mark it with a star. +If using a mirror for the operating system, mark all the drives where the TrueNAS operating system is installed. +Press Enter when done. + +The installer recognizes earlier versions of FreeNAS/TrueNAS installed on the boot drives and asks to either upgrade or do a fresh install: + +![InstallerUpgradeChoice](/images/CORE/Install/InstallerUpgradeChoice.png "Upgrade Choice") + +To perform an upgrade, press Enter to accept the default Upgrade Install. +The installer displays another reminder that you should install the operating system on a disk you are not using for storage. + +![InstallerUpgradeMethod](/images/CORE/Install/InstallerUpgradeMethod.png "Upgrade Method") + +You can install the updated system in a new boot environment or format the entire operating system device to start fresh. +Installing into a new boot environment preserves the old code, allowing a roll-back to previous versions if necessary. +Formatting the boot device is usually not necessary but can reclaim space. +TrueNAS preserves user data and settings when installing in a new boot environment and formatting the operating system device. +Move the highlight to one of the options and press Enter to start the upgrade. + +The installer unpacks the new image and checks for upgrades to the existing database file. +The database file that is preserved and migrated contains your TrueNAS configuration settings. + +![Installer Upgrade Preserved Database](/images/CORE/Install/InstallerUpgradePreservedDatabase.png "Preserved Database") + +Press Enter. +TrueNAS indicates that the upgrade is complete and a reboot is required. +Press *OK*, highlight `3 Reboot System`, then press Enter to reboot the system. +If the upgrade installer was booted from CD, remove the CD. + +During reboot, the previous configuration database can convert to the new version. +The conversion happens during the reboot `Applying database schema changes` line. +The conversion can take a long time to finish, sometimes fifteen minutes or more, and can cause the system to reboot again. +The system boots normally afterwards. +If database errors display but the web interface is accessible, log in, go to **System > General**, and use the **UPLOAD CONFIG** button to upload the configuration backup you downloaded before starting the upgrade. diff --git a/static/images/CORE/DownloadLatest.png b/static/images/CORE/DownloadLatest.png deleted file mode 100644 index 39f07002d8d8f883a64b1136ae1ab84d6e198655..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10405 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 LCRZV27W97r_Yo>{ From 0ce0b9e0a5a46a14f2d6416d49c9f7b29cc027fb Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 14:08:48 -0400 Subject: [PATCH 13/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index e5c0677a10..5f58e4a016 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -27,7 +27,7 @@ Select **SAVE CONFIGURATION** when prompted. Select an **Update File Temporary Storage Location** then click **Chose File** and browse to select the .tar file. Click **APPLY UPDATE**. -More details are available from [Updating Core]({{< relref "updatingcore.md" >}}). +More details are available from [Updating Core]({{< relref "/CORETutorials/UpdatingTrueNAS/_index.md" >}}). ## Release Schedule @@ -124,9 +124,10 @@ Notable changes: * SNMP agent bugfix ([NAS-125904](https://ixsystems.atlassian.net/browse/NAS-125904)). * Pagination offset and limit improvements for /api/v2.0/certificate ([NAS-126080](https://ixsystems.atlassian.net/browse/NAS-126080)). -Click here for the full changelog of completed tickets that are included in the 13.3-BETA.1 release. +Click here for the full changelog of completed tickets that are included in the 13.3-BETA.1 release. {{< include file="/static/includes/JiraFilterInstructions.md" >}} ### 13.3-BETA.1 Ongoing Issues -Click here to see the latest information about public issues discovered in 13.3-BETA.1 that are either being resolved in a future TrueNAS CORE release or are not to be fixed in CORE and are resolved in TrueNAS SCALE. +Click here to see the latest information about public issues discovered in 13.3-BETA.1 that are being resolved in a future TrueNAS CORE release. +This list also includes issues that are not to be fixed in CORE and are resolved in TrueNAS SCALE. From 0185eab204baa5f9172aad26bf6d6e2d84bbe73d Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 14:08:51 -0400 Subject: [PATCH 14/23] Update Install.md --- content/GettingStarted/Install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/GettingStarted/Install.md b/content/GettingStarted/Install.md index 7e3ce056a0..21177f5d3e 100644 --- a/content/GettingStarted/Install.md +++ b/content/GettingStarted/Install.md @@ -11,7 +11,7 @@ Now that the .iso file is [downloaded](https://www.truenas.com/down {{< expand "Major Upgrades" "v" >}} The install process can be repeated with newer installation files when the system already has TrueNAS installed. -This is used for [major version upgrades]({{< relref "UpdatingSoftwareforaMajorVersion.md" >}}) +This is used for [major version upgrades]({{< relref "/CORETutorials/UpdatingTrueNAS/_index.md#upgrade-via-iso" >}}) {{< /expand >}} {{< expand "ISO Verification" "v" >}} From e608c27243933be2cea94c5aabffe06d0e0126e1 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 14:55:52 -0400 Subject: [PATCH 15/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index 5f58e4a016..b054e8cc79 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -42,6 +42,19 @@ More details are available from [Updating Core]({{< relref "/CORETutorials/Updat ## Upgrade Notes +* Due to security vulnerabilities and maintainability issues, the S3 service is deprecated in TrueNAS CORE 13.0 and removed in CORE 13.3 ([NAS-127694](https://ixsystems.atlassian.net/browse/NAS-127694)). + Beginning in CORE 13.0-U6, the CORE web interface generates an alert when the deprecated service is either actively running or is enabled to start on boot. + Users should migrate to a separately maintained [MinIO plugin]({{< relref "MinIOPlugin.md" >}}) or otherwise move any production data away from the S3 service storage location before upgrading to 13.3. + See the CORE 13.0 tutorial for [detailed migration instructions](http://www.truenas.com/docs/core/13.0/coretutorials/jailspluginsvms/plugins/minioplugin/). + See also [Feature Deprecations]({{< relref "Deprecations.md" >}}). + +* The web UI **Shell** is removed in CORE 13.3. Users can continue to access the shell using [SSH]({{< relref "ConfiguringSSH.md" >}}) or a physical system connection with serial cable or other direct method ([NAS-124392](https://ixsystems.atlassian.net/browse/NAS-124392)). + +* The Plugins, Jails, and Virtual Machines features are untested and provided without support to the TrueNAS Community. + Users with a critical need to use containers or virtualization solutions in production should migrate to the tested and supported virtualization features available in [TrueNAS SCALE](https://www.truenas.com/download-truenas-scale/). + [TrueNAS Enterprise customers](https://www.truenas.com/truenas-enterprise/) can contact iXsystems to schedule a TrueNAS SCALE deployment. + See [CORE to SCALE Migrations](https://www.truenas.com/docs/scale/gettingstarted/migrate/) for more information. + ### Upgrade Paths **TrueNAS CORE** From f03aece91d20d6e3f973c28925db203d277b9be5 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 30 Apr 2024 14:55:55 -0400 Subject: [PATCH 16/23] Update Deprecations.md --- content/GettingStarted/Deprecations.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/GettingStarted/Deprecations.md b/content/GettingStarted/Deprecations.md index 8f543726b6..ef9a21b6f3 100644 --- a/content/GettingStarted/Deprecations.md +++ b/content/GettingStarted/Deprecations.md @@ -19,3 +19,15 @@ Begin planning migrations from these features immediately and note the TrueNAS u SAS Multipath is supported *as-is* and receives no further maintenance updates. While multipath situations might be detected and be generally functional in TrueNAS CORE, there is a possibility this is not available in a future TrueNAS CORE major version. Users should avoid creating and managing SAS multipath scenarios with TrueNAS. + +## Virtualization + +The Plugins, Jails, and Virtual Machines features are untested and provided without support to the TrueNAS Community. +Users with a critical need to use containers or virtualization solutions in production should migrate to the tested and supported virtualization features available in [TrueNAS SCALE](https://www.truenas.com/download-truenas-scale/). +[TrueNAS Enterprise customers](https://www.truenas.com/truenas-enterprise/) can contact iXsystems to schedule a TrueNAS SCALE deployment. +See [CORE to SCALE Migrations](https://www.truenas.com/docs/scale/gettingstarted/migrate/) for more information. + +## Web Shell + +The web UI **Shell** is removed in CORE 13.3. +Users can continue to access the shell using [SSH]({{< relref "ConfiguringSSH.md" >}}) or a physical system connection with serial cable or other direct method. From c9a5f15b97acc6d717f45177a2beee107ce3de0c Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Thu, 2 May 2024 14:32:11 -0400 Subject: [PATCH 17/23] Update COREReleaseNotes.md --- content/GettingStarted/COREReleaseNotes.md | 22 ++-------------------- 1 file changed, 2 insertions(+), 20 deletions(-) diff --git a/content/GettingStarted/COREReleaseNotes.md b/content/GettingStarted/COREReleaseNotes.md index b054e8cc79..8f06b3e826 100644 --- a/content/GettingStarted/COREReleaseNotes.md +++ b/content/GettingStarted/COREReleaseNotes.md @@ -5,6 +5,7 @@ weight: 3 aliases: related: false --- + {{< header logo="/images/truenas-core-logo.png" logo_alt="TrueNAS CORE Logo" version="13.3" icon="" icon_alt="" >}} {{< hint type="tip" title="13.3 Early Release Documentation">}} @@ -57,26 +58,7 @@ More details are available from [Updating Core]({{< relref "/CORETutorials/Updat ### Upgrade Paths -**TrueNAS CORE** - -{{< mermaid class="mermaid_sizing" >}} -flowchart LR - -A["11.0-U7"] -->|update| B["11.2-U8"] -B -->|update| C["11.3-U5"] -C -->|update| D["13.0-U6.1"] -D -->|"(anticipated)"| E["13.3.0"] -{{< /mermaid >}} - -**TrueNAS CORE Enterprise** - -{{< mermaid class="mermaid_sizing" >}} -flowchart LR - -A["11.0-U7"] -->|update| B["11.2-U8"] -B -->|update| C["11.3-U5"] -C -->|update| D["13.0-U6.1"] -{{< /mermaid >}} +{{< UpgradePaths product="CORE" >}} ## Component Versions From 2cf897186d0ae086d025e8027b9da83b7fd3b0a0 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Thu, 2 May 2024 14:36:01 -0400 Subject: [PATCH 18/23] Update core-releases.yaml --- data/properties/core-releases.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/data/properties/core-releases.yaml b/data/properties/core-releases.yaml index cd70b70f3e..f34d1e473e 100644 --- a/data/properties/core-releases.yaml +++ b/data/properties/core-releases.yaml @@ -26,7 +26,7 @@ majorVersions: name: "TrueNAS CORE 13.3" releaseName: "13.3" releases: - - name: "13.3-RC.1" + - name: "13.3-BETA.1" type: "Early" link: "https://www.truenas.com/docs/core/13.3/gettingstarted/corereleasenotes/#133-beta1-changelog" releaseDate: "2024-05-07" @@ -38,9 +38,9 @@ majorVersions: latest: false - name: "13.3-RC.1" type: "Early" - releaseDate: "2024-05-07" + releaseDate: "2024-06-18" latest: false - name: "13.3.0" type: "Stable" - releaseDate: "2024-06-18" + releaseDate: "" latest: false From 2b28b70889c02a6d38605362f3ed9814ac2c7f7e Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Thu, 2 May 2024 14:40:18 -0400 Subject: [PATCH 19/23] Create UpgradePaths.html --- layouts/shortcodes/UpgradePaths.html | 35 ++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 layouts/shortcodes/UpgradePaths.html diff --git a/layouts/shortcodes/UpgradePaths.html b/layouts/shortcodes/UpgradePaths.html new file mode 100644 index 0000000000..33c8695aeb --- /dev/null +++ b/layouts/shortcodes/UpgradePaths.html @@ -0,0 +1,35 @@ +{{/* layouts/shortcodes/UpgradePaths.html */}} +{{- $product := .Get "product" -}} +{{- $upgradePathFile := printf "/static/includes/%sUpgradePaths.md" $product -}} +{{- $logo := "" -}} +{{- $title := "" -}} + +{{- if eq $product "CORE" -}} + {{- $logo = "/images/truenas-core-logo.png" -}} + {{- $title = "TrueNAS CORE" -}} +{{- else if eq $product "SCALE" -}} + {{- $logo = "/images/tn-scale-logo.png" -}} + {{- $title = "TrueNAS SCALE" -}} +{{- end }} + +{{- $content := readFile $upgradePathFile -}} + +{{- with $content }} + + + +
+
+ {{ $title }} +
+
+ {{ . | markdownify }} +
+
+ +{{- end }} From af703ddf55d6fbb818bdb161816aaedd309f2255 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Thu, 2 May 2024 14:40:20 -0400 Subject: [PATCH 20/23] Update core_rest_api.html --- static/api/core_rest_api.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/static/api/core_rest_api.html b/static/api/core_rest_api.html index 19583bc7d9..f568c3c347 100644 --- a/static/api/core_rest_api.html +++ b/static/api/core_rest_api.html @@ -12,7 +12,7 @@
From d71d9cc4e2e04a71ba6139ffd66c5520394eeb07 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Thu, 2 May 2024 14:43:57 -0400 Subject: [PATCH 21/23] Create COREUpgradePaths.md --- static/includes/COREUpgradePaths.md | 50 +++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 static/includes/COREUpgradePaths.md diff --git a/static/includes/COREUpgradePaths.md b/static/includes/COREUpgradePaths.md new file mode 100644 index 0000000000..bc6e828cae --- /dev/null +++ b/static/includes/COREUpgradePaths.md @@ -0,0 +1,50 @@ + + +{{< mermaid class="mermaid_sizing" >}} +%%{ + init: { + 'theme': 'base', + 'themeVariables': { + 'primaryColor': '#FFFFFF', + 'primaryTextColor': '#000000', + 'primaryBorderColor': '#0095d5', + 'secondaryColor': '#70d4ff', + 'lineColor': '#0095d5', + 'secondaryTextColor': '#FFFFFF', + 'tertiaryColor': '#0095d5' + } + } +}%% + +flowchart LR + +A["11.0-U7"] -->|update| B["11.2-U8"] +B -->|update| C["11.3-U5"] +C -->|update| D["13.0-U6.1"] +D -->|"(anticipated)"| E["13.3.0"] +{{< /mermaid >}} + +TrueNAS CORE Enterprise + +{{< mermaid class="mermaid_sizing" >}} +%%{ + init: { + 'theme': 'base', + 'themeVariables': { + 'primaryColor': '#FFFFFF', + 'primaryTextColor': '#000000', + 'primaryBorderColor': '#0095d5', + 'secondaryColor': '#70d4ff', + 'lineColor': '#0095d5', + 'secondaryTextColor': '#FFFFFF', + 'tertiaryColor': '#0095d5' + } + } +}%% + +flowchart LR + +A["11.0-U7"] -->|update| B["11.2-U8"] +B -->|update| C["11.3-U5"] +C -->|update| D["13.0-U6.1"] +{{< /mermaid >}} From b75e90d1509694ca8bc0117ac8eda2a322fe693d Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Thu, 2 May 2024 14:45:21 -0400 Subject: [PATCH 22/23] Update words-to-ignore.txt --- words-to-ignore.txt | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/words-to-ignore.txt b/words-to-ignore.txt index 8f24276556..5c5b6406de 100644 --- a/words-to-ignore.txt +++ b/words-to-ignore.txt @@ -2022,4 +2022,10 @@ pathname iSCSIShare SharingStorage Diskgraphs -msec \ No newline at end of file +msec +EarlyReleaseWarning +UpdatingTrueNAS +UpgradePaths +Bugfix +zettarepl +bugfix From 9ae459539415e11060e9bb6a64ca61f6c14731a2 Mon Sep 17 00:00:00 2001 From: tonyriv3 <75626853+tonyriv3@users.noreply.github.com> Date: Fri, 3 May 2024 15:37:20 -0400 Subject: [PATCH 23/23] Update _index.md --- content/CORETutorials/UpdatingTrueNAS/_index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/CORETutorials/UpdatingTrueNAS/_index.md b/content/CORETutorials/UpdatingTrueNAS/_index.md index 763314c1f7..f6612ac4cf 100644 --- a/content/CORETutorials/UpdatingTrueNAS/_index.md +++ b/content/CORETutorials/UpdatingTrueNAS/_index.md @@ -72,7 +72,7 @@ To go back to an earlier version after testing or running a more recent version, {{< /hint >}} Information about the update displays with a link to the release notes. -Alwys read the release notes before updating to determine if any of the changes in that release impact system use. +Always read the release notes before updating to determine if any of the changes in that release impact system use. ### Save the Configuration File @@ -113,7 +113,7 @@ While updating, TrueNAS only downloads files that changed in the base operating Delta update packages are more efficient than full update packages, providing a faster update and taking less bandwidth. By contrast, a full update package downloads all the files included in the base system, even if those files have not changed. -While the full package might require more time to install, there are some rare cases where it is necessary, such as when aplying a patch as a temporary fix to a local system. +While the full package might require more time to install, there are some rare cases where it is necessary, such as when applying a patch as a temporary fix to a local system. A patch fixes a bug within the main codebase. While software patches often fix bugs, they can also repair security issues or add new features. @@ -197,7 +197,7 @@ The installer displays another reminder that you should install the operating sy ![InstallerUpgradeMethod](/images/CORE/Install/InstallerUpgradeMethod.png "Upgrade Method") You can install the updated system in a new boot environment or format the entire operating system device to start fresh. -Installing into a new boot environment preserves the old code, allowing a roll-back to previous versions if necessary. +Installing into a new boot environment preserves the old code, allowing a rollback to previous versions if necessary. Formatting the boot device is usually not necessary but can reclaim space. TrueNAS preserves user data and settings when installing in a new boot environment and formatting the operating system device. Move the highlight to one of the options and press Enter to start the upgrade. @@ -210,10 +210,10 @@ The database file that is preserved and migrated contains your TrueNAS configura Press Enter. TrueNAS indicates that the upgrade is complete and a reboot is required. Press *OK*, highlight `3 Reboot System`, then press Enter to reboot the system. -If the upgrade installer was booted from CD, remove the CD. +If the upgrade installer was booted from a CD, remove the CD. During reboot, the previous configuration database can convert to the new version. The conversion happens during the reboot `Applying database schema changes` line. The conversion can take a long time to finish, sometimes fifteen minutes or more, and can cause the system to reboot again. -The system boots normally afterwards. +The system boots normally afterward. If database errors display but the web interface is accessible, log in, go to **System > General**, and use the **UPLOAD CONFIG** button to upload the configuration backup you downloaded before starting the upgrade.