From 97f174eb6e07287e8e2fe15422bbb16e54463bc5 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 3 Feb 2025 12:52:35 -0500 Subject: [PATCH 01/25] Update SCALEReleaseNotes.md --- .../SCALE/GettingStarted/SCALEReleaseNotes.md | 20 ++++++------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/content/SCALE/GettingStarted/SCALEReleaseNotes.md b/content/SCALE/GettingStarted/SCALEReleaseNotes.md index 8b3cedf12e..f1792394ef 100644 --- a/content/SCALE/GettingStarted/SCALEReleaseNotes.md +++ b/content/SCALE/GettingStarted/SCALEReleaseNotes.md @@ -82,9 +82,8 @@ More details are available from [Software Releases]({{< relref "/TrueNASUpgrades {{< include file="/static/includes/MigratingVMs.md" >}} ### Upgrade Paths (Anticipated) - {{< include file="/static/includes/SCALEUpgradePaths.md" >}} @@ -134,14 +133,6 @@ Any new feature flags introduced since the previous OpenZFS version that was int 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 with a versioned JSON-RPC 2.0 over WebSocket API ([API Reference]({{< relref "/scale/api/_index.md" >}})). Full removal of the REST API is planned for a future release. -* Improved API key mechanism with support for user-linked API keys ([NAS-131396](https://ixsystems.atlassian.net/browse/NAS-131396)). -* 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)). - - \ No newline at end of file From 556d1425632e5f1b7ccd97852c08703b0555b5d1 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 10 Feb 2025 11:11:28 -0500 Subject: [PATCH 02/25] Update UseScaleShell.md --- content/SCALETutorials/SystemSettings/UseScaleShell.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/SCALETutorials/SystemSettings/UseScaleShell.md b/content/SCALETutorials/SystemSettings/UseScaleShell.md index 669e6fd4f5..6be7afe501 100644 --- a/content/SCALETutorials/SystemSettings/UseScaleShell.md +++ b/content/SCALETutorials/SystemSettings/UseScaleShell.md @@ -13,7 +13,7 @@ The TrueNAS **Shell** is convenient for running command line tools, configuring {{< hint type=warning >}} Warning! The supported mechanisms for making configuration changes are the TrueNAS WebUI and API exclusively. -All other are not supported and result in undefined behavior that can result in system failure! +All others are not supported and result in undefined behavior that can result in system failure! {{< /hint >}} {{< trueimage src="/images/SCALE/CLI/SystemShellSCALE.png" alt="Shell Screen" id="Shell Screen" >}} From b461e348c0bba6219961e7a1551668957eebd42e Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 10 Feb 2025 13:02:08 -0500 Subject: [PATCH 03/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 98c4af34c5..76597e6fac 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -140,15 +140,15 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp Notable changes: -* The TrueNAS REST API is deprecated in TrueNAS 25.04 and replaced with a versioned JSON-RPC 2.0 over WebSocket API ([API Reference]({{< relref "/scale/api/_index.md" >}})). Full removal of the REST API is planned for a future release. +* The TrueNAS REST API is deprecated in TrueNAS 25.04 and replaced with a versioned JSON-RPC 2.0 over WebSocket API ([API Reference]({{< relref "/api/_index.md" >}})). Full removal of the REST API is planned for a future release. * Improved API key mechanism with support for user-linked API keys ([NAS-131396](https://ixsystems.atlassian.net/browse/NAS-131396)). * 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)). -Click here for the full changelog of completed tickets that are included in the 25.04-BETA.1 release. +Click here for the full changelog of completed tickets that are included in the 25.04-BETA.1 release. {{< include file="/static/includes/JiraFilterInstructions.md" >}} ### 25.04-BETA.1 Known Issues * An issue has been discovered for cloud sync tasks configured with file name encryption, which is available in **Advanced Remote Options** ([NAS-132472](https://ixsystems.atlassian.net/browse/NAS-132472)). As this is an upstream issue in rclone, we recommend that users should not create new cloud sync tasks with the **Filename Encryption** setting enabled. Existing users of this feature must leave it enabled for existing cloud sync tasks to be able to recover backups. -Click here to see the latest information about public issues discovered in 25.04-BETA.1 that are being resolved in a future TrueNAS release. +Click here to see the latest information about public issues discovered in 25.04-BETA.1 that are being resolved in a future TrueNAS release. From 1270ec2f5020afdcaea9cbd26d14bcd00bd343f4 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 10 Feb 2025 15:50:40 -0500 Subject: [PATCH 04/25] Component versions redesign (#3494) * Update SCALEReleaseNotes.md * Create component_versions.yaml * Create component-versions.html * Update custom.css * Update SCALEReleaseNotes.md * Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 11 ++----- data/properties/component_versions.yaml | 33 +++++++++++++++++++++ layouts/shortcodes/component-versions.html | 31 +++++++++++++++++++ static/custom.css | 19 ++++++++++++ 4 files changed, 86 insertions(+), 8 deletions(-) create mode 100644 data/properties/component_versions.yaml create mode 100644 layouts/shortcodes/component-versions.html diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 76597e6fac..7fe11209bf 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -103,18 +103,13 @@ Enterprise customers should [contact Support](https://www.truenas.com/docs/scale --> ## Component Versions -Component version numbers below are updated to reflect the latest TrueNAS 24.05 release. + Click the component version number to see release notes for that component. -{{< truetable >}} -| Component | Version | -|-----------|-------------| -| 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 >}} +{{< component-versions "25.04" >}} ### OpenZFS Feature Flags + TrueNAS integrates many features provided by the upstream [OpenZFS project](https://openzfs.org/wiki/Main_Page). Any new feature flags introduced since the previous OpenZFS version that was integrated into TrueNAS (OpenZFS 2.2.99) are listed below: diff --git a/data/properties/component_versions.yaml b/data/properties/component_versions.yaml new file mode 100644 index 0000000000..361fef7510 --- /dev/null +++ b/data/properties/component_versions.yaml @@ -0,0 +1,33 @@ +# Works in conjunction with shortcodes/component-versions.html +# The shortcode generates a table containing ordered component versions for each minor version release. + +# Add in component version information for each minor version release of a major version. +# A major version can be individually called in release notes with {{< component-versions "##.##" >}} + +# Each list section (major_version, release_order, and release) should start with the latest and move toward older releases. +# Insert new major or minor version release data above existing entries. + +major_version: + "25.04": + release_order: # list minor version releases in order, starting with the latest + - "25.04-BETA.1" + component_order: # list components in the order they should appear in the left column + - "linux_kernel" + - "openzfs" + - "docker_engine" + - "nvidia_driver" + release: # include each release with component versions and links + "25.04-BETA.1": + components: + linux_kernel: + version: "6.12.9" + link: "https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tag/?h=v6.12.9" + openzfs: + version: "2.3.0-1" + link: "https://github.com/openzfs/zfs/releases/tag/zfs-2.3.0" + docker_engine: + version: "27.5.0" + link: "https://docs.docker.com/engine/release-notes/27/#2750" + nvidia_driver: + version: "550.142" + link: "https://www.nvidia.com/en-us/drivers/details/237853/" diff --git a/layouts/shortcodes/component-versions.html b/layouts/shortcodes/component-versions.html new file mode 100644 index 0000000000..274679aec1 --- /dev/null +++ b/layouts/shortcodes/component-versions.html @@ -0,0 +1,31 @@ +{{- $componentNames := dict "linux_kernel" "Linux Kernel" "openzfs" "OpenZFS" "docker_engine" "Docker Engine" "nvidia_driver" "NVIDIA Driver" -}} + +{{- $version := .Get 0 -}} +{{- with .Site.Data.properties.component_versions.major_version -}} + {{- $versionData := index . $version -}} + + + + + + {{- range $releaseVersion := $versionData.release_order }} + + {{- end }} + + + + {{- range $componentName := $versionData.component_order }} + + + {{- range $releaseVersion := $versionData.release_order }} + + {{- end }} + + {{- end }} + +
{{ $releaseVersion }}
{{ index $componentNames $componentName }} + + {{ index (index $versionData.release $releaseVersion) "components" $componentName "version" }} + +
+{{- end }} diff --git a/static/custom.css b/static/custom.css index 8eccb17a21..8b08ecd679 100644 --- a/static/custom.css +++ b/static/custom.css @@ -1868,6 +1868,24 @@ table.graph-inputs select.ydata { /* End Style for capacity graph "graph-inputs" */ +/* Style for the container of tables with class "component-versions-table" */ +/* Set background color for the top row and left column */ +.component-versions-table th, +.component-versions-table td:first-child { + background-color: #0095d5; + color: white; + font-weight: 600; +} + +/* Exclude the first cell (top-left) from the background color */ +.component-versions-table th:first-child { + background-color: var(--body-background); + border-top: none; + border-left: none; +} + +/* end style for the container of tables with class "component-versions-table" */ + /* Style for draid visualizer */ div.draid-grid-container { display: grid; @@ -2404,6 +2422,7 @@ pre.gdoc-mermaid.mermaid.mermaid_sizing { } /* End style for Logo and Icon*/ +/* Styling for Community Edition and Enterprise logos */ .edition-logo { height: 24px !important; vertical-align: middle !important; From ae07334374b17949beb21444108d5903a058589d Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 10 Feb 2025 16:55:37 -0500 Subject: [PATCH 05/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 7fe11209bf..8eaaadae27 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -37,13 +37,7 @@ More details are available from [Software Releases](https://www.truenas.com/docs ## Upgrade Notes -* TrueNAS is an appliance built from specific Linux packages. - Attempting to update TrueNAS with `apt` or methods other than the TrueNAS web interface can result in a nonfunctional system. - -* All auxiliary parameters can experience changes between TrueNAS major versions due to security and development changes. - We recommend removing all auxiliary parameters from TrueNAS configurations before upgrading as these settings can result in SMB share failures after an upgrade. - -* {{< include file="/static/includes/UpgradeClearCache.md" >}} +{{< include file="/static/includes/UpgradeNotesBoilerplate.md" >}} * {{< include file="/static/includes/RESTAPIDeprecationNotice.md" >}} @@ -121,7 +115,7 @@ Any new feature flags introduced since the previous OpenZFS version that was int 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-BETA.1 Changelog +## 25.04-BETA.1 {{< hint type=warning title="Early Release Software" >}} Early releases are intended for testing and feedback purposes. @@ -133,7 +127,7 @@ Do not use early-release software for critical tasks. iXsystems is pleased to release TrueNAS 25.04-BETA.1! This first public release version of TrueNAS 25.04 (Fangtooth) has software component updates and new features that are in the polishing phase. -Notable changes: +### Notable changes * The TrueNAS REST API is deprecated in TrueNAS 25.04 and replaced with a versioned JSON-RPC 2.0 over WebSocket API ([API Reference]({{< relref "/api/_index.md" >}})). Full removal of the REST API is planned for a future release. * Improved API key mechanism with support for user-linked API keys ([NAS-131396](https://ixsystems.atlassian.net/browse/NAS-131396)). @@ -142,7 +136,7 @@ Notable changes: Click here for the full changelog of completed tickets that are included in the 25.04-BETA.1 release. {{< include file="/static/includes/JiraFilterInstructions.md" >}} -### 25.04-BETA.1 Known Issues +### Known Issues * An issue has been discovered for cloud sync tasks configured with file name encryption, which is available in **Advanced Remote Options** ([NAS-132472](https://ixsystems.atlassian.net/browse/NAS-132472)). As this is an upstream issue in rclone, we recommend that users should not create new cloud sync tasks with the **Filename Encryption** setting enabled. Existing users of this feature must leave it enabled for existing cloud sync tasks to be able to recover backups. From 64d81e8d5f39fa2025c882372e3a31c1aea75ee3 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 10 Feb 2025 16:55:42 -0500 Subject: [PATCH 06/25] Update scale-releases.yaml --- data/properties/scale-releases.yaml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/data/properties/scale-releases.yaml b/data/properties/scale-releases.yaml index 55c12e15de..ae8166b31f 100644 --- a/data/properties/scale-releases.yaml +++ b/data/properties/scale-releases.yaml @@ -26,16 +26,11 @@ majorVersions: name: "TrueNAS 25.04 - Fangtooth" releaseName: "Fangtooth" releases: - - name: "25.04 Nightlies" - type: "Experimental" - link: "https://www.truenas.com/docs/scale/25.04/gettingstarted/scalereleasenotes/" - releaseDate: "2024-08-13" - latest: true - name: "25.04-BETA.1" type: "Early" - link: "" + link: "https://www.truenas.com/docs/scale/25.04/gettingstarted/scalereleasenotes/#2504-beta1" releaseDate: "2025-02-13" - latest: false + latest: true - name: "25.04-RC.1" type: "Early" link: "" @@ -46,3 +41,8 @@ majorVersions: link: "" releaseDate: "2025-04-15" latest: false + - name: "25.04 Nightlies" + type: "Experimental" + link: "https://www.truenas.com/docs/scale/25.04/gettingstarted/scalereleasenotes/" + releaseDate: "2024-08-13" + latest: false \ No newline at end of file From a735c56c319f283b13633f2d0d7c09cde3463d12 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Mon, 10 Feb 2025 16:55:44 -0500 Subject: [PATCH 07/25] Create UpgradeNotesBoilerplate.md --- static/includes/UpgradeNotesBoilerplate.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 static/includes/UpgradeNotesBoilerplate.md diff --git a/static/includes/UpgradeNotesBoilerplate.md b/static/includes/UpgradeNotesBoilerplate.md new file mode 100644 index 0000000000..2c2549e5e5 --- /dev/null +++ b/static/includes/UpgradeNotesBoilerplate.md @@ -0,0 +1,12 @@ + + +* TrueNAS is an appliance built from specific Linux packages. + Attempting to update TrueNAS with `apt` or methods other than the TrueNAS web interface can result in a nonfunctional system. + +* All auxiliary parameters can experience changes between TrueNAS major versions due to security and development changes. + We recommend removing all auxiliary parameters from TrueNAS configurations before upgrading as these settings can result in SMB share failures after an upgrade. + +* {{< include file="/static/includes/UpgradeClearCache.md" >}} + +* Application maintenance, including version updates, features, and configuration options, is independent from TrueNAS version release cycles. + See the [TrueNAS Apps](https://www.truenas.com/docs/truenasapps/) documentation and the [truenas/apps](https://github.com/truenas/apps/issues) repository for more information. From 49d001b5cabc7078f62980b0c0c5817d399f9910 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 13:38:00 -0500 Subject: [PATCH 08/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 8eaaadae27..01b4ce8b23 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -132,6 +132,18 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp * The TrueNAS REST API is deprecated in TrueNAS 25.04 and replaced with a versioned JSON-RPC 2.0 over WebSocket API ([API Reference]({{< relref "/api/_index.md" >}})). Full removal of the REST API is planned for a future release. * Improved API key mechanism with support for user-linked API keys ([NAS-131396](https://ixsystems.atlassian.net/browse/NAS-131396)). * 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)). +* UI login experience improvements ([NAS-130810](https://ixsystems.atlassian.net/browse/NAS-130810)). +* NFS over RDMA support - Enterprise Feature ([NAS-131784](https://ixsystems.atlassian.net/browse/NAS-131784)). +* iSCSI Extensions for RDMA (iSER) support ([NAS-106190](https://ixsystems.atlassian.net/browse/NAS-106190)). +* ZFS Fast deduplication support ([NAS-127088](https://ixsystems.atlassian.net/browse/NAS-127088)). +* Incus Container & VM Support - Experimental Community Feature ([NAS-130251](https://ixsystems.atlassian.net/browse/NAS-130251)). +* Hide SED related options in the UI for non-Enterprise users ([NAS-133442](https://ixsystems.atlassian.net/browse/NAS-133442)). +* Bump nvidia driver version ([NAS-133575](https://ixsystems.atlassian.net/browse/NAS-133575)). +* Remove integrated Netdata web portal from the TrueNAS UI and middleware ([NAS-133629](https://ixsystems.atlassian.net/browse/NAS-133629)). + Default Netdata integration is removed due to STIG security requirements. + Users who want to continue using Netdata monitoring can install Netdata from the TrueNAS Apps catalog. +* Bugfix: "Cache and Spare disks are not recognized post upgrade from 13.0 U6.2 to 24.04.2" ([NAS-130825](https://ixsystems.atlassian.net/browse/NAS-130825)). +* Bugfix: "Unable to start a VM due to insufficient memory" ([NAS-128544](https://ixsystems.atlassian.net/browse/NAS-128544)). Click here for the full changelog of completed tickets that are included in the 25.04-BETA.1 release. {{< include file="/static/includes/JiraFilterInstructions.md" >}} @@ -139,5 +151,6 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp ### Known Issues * An issue has been discovered for cloud sync tasks configured with file name encryption, which is available in **Advanced Remote Options** ([NAS-132472](https://ixsystems.atlassian.net/browse/NAS-132472)). As this is an upstream issue in rclone, we recommend that users should not create new cloud sync tasks with the **Filename Encryption** setting enabled. Existing users of this feature must leave it enabled for existing cloud sync tasks to be able to recover backups. +* Unable to Create dataset under disks while configuring a new virtualization Instance ([NAS-134151](https://ixsystems.atlassian.net/browse/NAS-134151)). Click here to see the latest information about public issues discovered in 25.04-BETA.1 that are being resolved in a future TrueNAS release. From fa8b13c58ca942b0ad790aa23797eadab26b0af7 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 13:38:02 -0500 Subject: [PATCH 09/25] Update AddingNFSShares.md --- content/SCALETutorials/Shares/AddingNFSShares.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/SCALETutorials/Shares/AddingNFSShares.md b/content/SCALETutorials/Shares/AddingNFSShares.md index 1a07c4fa6c..e6a407055a 100644 --- a/content/SCALETutorials/Shares/AddingNFSShares.md +++ b/content/SCALETutorials/Shares/AddingNFSShares.md @@ -148,7 +148,7 @@ NFS over RDMA support requires an active Enterprise license and RDMA capable net Interested customers should contact Enterprise Support for assistance. {{< expand "Contacting Support" "v" >}} -{{< include file="static\includes\iXsystemsSupportContact.md" >}} +{{< include file="/static/includes/iXsystemsSupportContact.md" >}} {{< /expand >}} {{< /enterprise >}} From ad3562b7226d267d6bb82b1f660007ff7aa1613b Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 13:38:05 -0500 Subject: [PATCH 10/25] Update 25.04FeatureList.md --- static/includes/25.04FeatureList.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/static/includes/25.04FeatureList.md b/static/includes/25.04FeatureList.md index 08705758a1..c86622a43d 100644 --- a/static/includes/25.04FeatureList.md +++ b/static/includes/25.04FeatureList.md @@ -4,10 +4,12 @@ TrueNAS 25.04 (Fangtooth) brings many new features and improvements to the TrueN {{< columns >}} * NFS over RDMA support (Enterprise Feature - see [Configuring the NFS Service]({{< relref "/scaletutorials/shares/addingnfsshares.md#configuring-the-nfs-service" >}})) + +* iSCSI over RDMA support (Enterprise Feature) * iSCSI Fibre Channel support (Enterprise Feature) -* Versioned TrueNAS JSON-RPC 2.0 over WebSocket API (see [API Reference]({{< relref "/API/_index.md" >}})) +* Versioned TrueNAS JSON-RPC 2.0 over WebSocket API with new and improved API documentation (see [API Reference]({{< relref "/API/_index.md" >}})) * User-linked API Keys (see [Managing API Keys]({{< relref "/scaletutorials/toptoolbar/managingapikeys.md" >}})) From 56aab9e97f39bb62cb13627c6991ec6d79ca50e5 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 13:55:34 -0500 Subject: [PATCH 11/25] Feature Flags Table improvements --- content/GettingStarted/SCALEReleaseNotes.md | 2 +- layouts/shortcodes/truetable.html | 4 +- static/custom.css | 59 ++++++++++++++------- 3 files changed, 44 insertions(+), 21 deletions(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 01b4ce8b23..c308073a01 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -107,7 +107,7 @@ Click the component version number to see release notes for that component. TrueNAS integrates many features provided by the upstream [OpenZFS project](https://openzfs.org/wiki/Main_Page). Any new feature flags introduced since the previous OpenZFS version that was integrated into TrueNAS (OpenZFS 2.2.99) are listed below: -{{< truetable >}} +{{< truetable class="tn-blue" >}} | Feature Flag | GUID | Notes | |--------------|------|-------| | 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. | diff --git a/layouts/shortcodes/truetable.html b/layouts/shortcodes/truetable.html index 42f91d8f07..fe8d07c1f9 100644 --- a/layouts/shortcodes/truetable.html +++ b/layouts/shortcodes/truetable.html @@ -1,3 +1,3 @@ -
+
{{ print .Inner | markdownify }} -
\ No newline at end of file +
diff --git a/static/custom.css b/static/custom.css index 8b08ecd679..c65a45fbec 100644 --- a/static/custom.css +++ b/static/custom.css @@ -1235,6 +1235,11 @@ pre.chroma { } .truetable tr:hover {background-color: var(--accent-color);} .truetable tr:nth-child(even):hover {background-color: var(--accent-color)!important;} + +.truetable thead tr:hover { + background-color: transparent; /* Remove hover effect from header */ + } + /* Adjust for tables inside Enterprise shortcode */ .gdoc-hint.note .truenas-enterprise__text .truetable tr {background-color: rgba(134,142,150,.05);} .gdoc-hint.note .truenas-enterprise__text .truetable tr:hover {background-color: #e6e6e6!important;} @@ -1248,8 +1253,44 @@ pre.chroma { width: unset; } /* End Adjust to prevent tables in expand elements overflowing container */ + +/* Adjust for additional class tn-blue */ +.tn-blue table thead { + background-color: #0095d5; + color: white; +} /* End standardized table styling */ +/* Style for the container of tables with class "component-versions-table" */ + +/* Set background color for the top row and left column */ +.component-versions-table th, +.component-versions-table td:first-child { + background-color: #0095d5; + color: white; + font-weight: 600; +} + +/* Exclude the first cell (top-left) from the background color */ +.component-versions-table th:first-child { + background-color: var(--body-background); + border-top: none; + border-left: none; +} + +/* Highlight individual cells (excluding first column and header row) on hover */ +.component-versions-table td:not(:first-child):hover { + background-color: var(--accent-color); + color: white; +} + +/* Prevent header row from being highlighted on hover */ +.component-versions-table thead tr:hover { + background-color: transparent; /* Ensure header row stays unaffected */ +} + +/* End style for the container of tables with class "component-versions-table" */ + /* Standardize image styling */ .trueimg { justify-content:center; @@ -1868,24 +1909,6 @@ table.graph-inputs select.ydata { /* End Style for capacity graph "graph-inputs" */ -/* Style for the container of tables with class "component-versions-table" */ -/* Set background color for the top row and left column */ -.component-versions-table th, -.component-versions-table td:first-child { - background-color: #0095d5; - color: white; - font-weight: 600; -} - -/* Exclude the first cell (top-left) from the background color */ -.component-versions-table th:first-child { - background-color: var(--body-background); - border-top: none; - border-left: none; -} - -/* end style for the container of tables with class "component-versions-table" */ - /* Style for draid visualizer */ div.draid-grid-container { display: grid; From 90fdeae8507f656e063f069e835c703006b2c659 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 13:59:45 -0500 Subject: [PATCH 12/25] Update scale-releases.yaml --- data/properties/scale-releases.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/properties/scale-releases.yaml b/data/properties/scale-releases.yaml index ae8166b31f..21effad552 100644 --- a/data/properties/scale-releases.yaml +++ b/data/properties/scale-releases.yaml @@ -45,4 +45,4 @@ majorVersions: type: "Experimental" link: "https://www.truenas.com/docs/scale/25.04/gettingstarted/scalereleasenotes/" releaseDate: "2024-08-13" - latest: false \ No newline at end of file + latest: false From 080d3856d8ca015205f4cf811abcb5610b14df40 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 16:31:33 -0500 Subject: [PATCH 13/25] Apply review suggestions --- content/GettingStarted/SCALEReleaseNotes.md | 1 + static/includes/25.04FeatureList.md | 8 ++++---- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index c308073a01..fd915751dc 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -136,6 +136,7 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp * NFS over RDMA support - Enterprise Feature ([NAS-131784](https://ixsystems.atlassian.net/browse/NAS-131784)). * iSCSI Extensions for RDMA (iSER) support ([NAS-106190](https://ixsystems.atlassian.net/browse/NAS-106190)). * ZFS Fast deduplication support ([NAS-127088](https://ixsystems.atlassian.net/browse/NAS-127088)). +* iSCSI and ZVOL block cloning support ([NAS-130017](ixsystems.atlassian.net/browse/NAS-130017)). * Incus Container & VM Support - Experimental Community Feature ([NAS-130251](https://ixsystems.atlassian.net/browse/NAS-130251)). * Hide SED related options in the UI for non-Enterprise users ([NAS-133442](https://ixsystems.atlassian.net/browse/NAS-133442)). * Bump nvidia driver version ([NAS-133575](https://ixsystems.atlassian.net/browse/NAS-133575)). diff --git a/static/includes/25.04FeatureList.md b/static/includes/25.04FeatureList.md index c86622a43d..71f14942c2 100644 --- a/static/includes/25.04FeatureList.md +++ b/static/includes/25.04FeatureList.md @@ -4,10 +4,10 @@ TrueNAS 25.04 (Fangtooth) brings many new features and improvements to the TrueN {{< columns >}} * NFS over RDMA support (Enterprise Feature - see [Configuring the NFS Service]({{< relref "/scaletutorials/shares/addingnfsshares.md#configuring-the-nfs-service" >}})) - -* iSCSI over RDMA support (Enterprise Feature) -* iSCSI Fibre Channel support (Enterprise Feature) +* Fibre Channel support (Enterprise Feature) + +* iSCSI and ZVOL block cloning support ([NAS-130017](https://ixsystems.atlassian.net/browse/NAS-130017)) * Versioned TrueNAS JSON-RPC 2.0 over WebSocket API with new and improved API documentation (see [API Reference]({{< relref "/API/_index.md" >}})) @@ -15,7 +15,7 @@ TrueNAS 25.04 (Fangtooth) brings many new features and improvements to the TrueN * Improved UI Login Experience ([NAS-130810](https://ixsystems.atlassian.net/browse/NAS-130810)) -* Improved STIG Compliance and Security Focus ([NAS-127235](https://ixsystems.atlassian.net/browse/NAS-127235)) +* Improved STIG Compliance and Security Focus (Enterprise Feature - [NAS-127235](https://ixsystems.atlassian.net/browse/NAS-127235)) * Enable support for ZFS Fast Deduplication ([NAS-127088](https://ixsystems.atlassian.net/browse/NAS-127088)) From 3c24cfa25d17c565db4969d493d7f5145bec7472 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 16:35:38 -0500 Subject: [PATCH 14/25] typo fix --- content/API/_index.md | 2 +- content/GettingStarted/SCALEReleaseNotes.md | 2 +- content/SCALETutorials/TopToolbar/ManagingAPIKeys.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/API/_index.md b/content/API/_index.md index 95eabaefef..8f8b5bf50a 100644 --- a/content/API/_index.md +++ b/content/API/_index.md @@ -25,7 +25,7 @@ Alternatively, append `/api/docs/` to your TrueNAS host name or IP address in a ## API Access User-linked API access keys allow administrators to configure per-user access to the TrueNAS API. -Keys are revokable and can be configured to automatically expire on a preset date. +Keys are revocable and can be configured to automatically expire on a preset date. {{< include file="/static/includes/API_AD.md" >}} diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index fd915751dc..ff0bd4f2d4 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -47,7 +47,7 @@ More details are available from [Software Releases](https://www.truenas.com/docs Click **API Docs** to view API documentation. * 25.04 also introduces user-linked API access keys, allowing administrators to configure per-user access to the TrueNAS API. - Keys are revokable and can be configured to automatically expire on a preset date. + Keys are revocable and can be configured to automatically expire on a preset date. {{< include file="/static/includes/API_AD.md" >}} diff --git a/content/SCALETutorials/TopToolbar/ManagingAPIKeys.md b/content/SCALETutorials/TopToolbar/ManagingAPIKeys.md index fbdf3000d0..431356b49a 100644 --- a/content/SCALETutorials/TopToolbar/ManagingAPIKeys.md +++ b/content/SCALETutorials/TopToolbar/ManagingAPIKeys.md @@ -10,7 +10,7 @@ tags: TrueNAS 25.04 and later uses a versioned JSON-RPC 2.0 over WebSocket API with support for user-linked API access keys ([API Reference]({{< relref "/api/_index.md" >}})). User-linked API keys allow administrators to configure per-user access to the TrueNAS API. -Keys are revokable and can be configured to automatically expire on a preset date. +Keys are revocable and can be configured to automatically expire on a preset date. Click **My API Keys** on the top right toolbar user settings dropdown menu to open the **User API Keys** screen. From c9de342f8f2a7360e168870c8dca8b15d21cb291 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 16:35:46 -0500 Subject: [PATCH 15/25] Update words-to-ignore.txt --- words-to-ignore.txt | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/words-to-ignore.txt b/words-to-ignore.txt index da51d0754a..b897584fa8 100644 --- a/words-to-ignore.txt +++ b/words-to-ignore.txt @@ -2158,3 +2158,37 @@ MiniFamilyFront SOV MiniNetworkPortID InstallWizardResourceConfig +RESTAPIDeprecationNotice +APIKeyMigrate +APIDocs +APIKeyWarn +toptoolbar +managingapikeys +thirdpartymigration +EarlyReleaseWarning +UpgradeNotesBoilerplate +libvirt-qemu +Incus +MigratingVMs +RDMA +iSER +Bugfix +NetdataUI +NetdataCredentialsDialog +DashboardMainScreen +DashboardSystemInfoWidget +DashboardHASystemInformationWidgets +DashboardCPUWidget +DashboardMemoryWidget +DashboardNetworkWidget +DashboardStorageWidget +DashboardPoolWidget +DashboardBackupTasksEmpty +DashboardBackupTasks +DashboardHelpWidget +DashboardInConfigMode +Esc +WidgetEditorAddNew +WidgetEditorExistingWidget +scrollbars +DashboardMainHAScreen From f4aba90986636b6e19bdcd658d3e9b8a3ade0da8 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Tue, 11 Feb 2025 16:45:30 -0500 Subject: [PATCH 16/25] Update custom.css --- static/custom.css | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/static/custom.css b/static/custom.css index c65a45fbec..59d656eda8 100644 --- a/static/custom.css +++ b/static/custom.css @@ -1278,6 +1278,17 @@ pre.chroma { border-left: none; } +/* Apply border styles to match truetable */ +.component-versions-table { + border-collapse: collapse; +} + +.component-versions-table td, +.component-versions-table th { + border: .5px solid var(--accent-color); + padding: .5rem; +} + /* Highlight individual cells (excluding first column and header row) on hover */ .component-versions-table td:not(:first-child):hover { background-color: var(--accent-color); From 8f3c3b4782cf29a8894948ddba7f6f0f88626b62 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 09:33:55 -0500 Subject: [PATCH 17/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index ff0bd4f2d4..6ca1ae6019 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -153,5 +153,17 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp * An issue has been discovered for cloud sync tasks configured with file name encryption, which is available in **Advanced Remote Options** ([NAS-132472](https://ixsystems.atlassian.net/browse/NAS-132472)). As this is an upstream issue in rclone, we recommend that users should not create new cloud sync tasks with the **Filename Encryption** setting enabled. Existing users of this feature must leave it enabled for existing cloud sync tasks to be able to recover backups. * Unable to Create dataset under disks while configuring a new virtualization Instance ([NAS-134151](https://ixsystems.atlassian.net/browse/NAS-134151)). +* UUID related traceback when activating NVIDIA GPU for Jellyfin app: `base_v2_1_14.error.RenderError: Expected [uuid] to be set for GPU in slot [0000:01:00.0] in [nvidia_gpu_selection]` ([NAS-134152](https://ixsystems.atlassian.net/browse/NAS-134152)). + + Users experiencing this error should follow the steps below for a one time fix that should not need to be repeated. + + Connect to a shell session and retrieve the UUID for each GPU with the command `midclt call app.gpu_choices | jq`. + + For each application that experiences the error, run `midclt call -job app.update APP_NAME '{"values": {"resources": {"gpus": {"use_all_gpus": false, "nvidia_gpu_selection": {"PCI_SLOT": {"use_gpu": true, "uuid": "GPU_UUID"}}}}}}'` + Where: + * `APP_NAME` is the name you entered in the application, for example “plex”. + * `PCI_SLOT` is the pci slot identified in the error, for example "0000:2d:00.0”. + * `GPU_UUID` is the UUID matching the pci slot that you retrieved with the above command. + Click here to see the latest information about public issues discovered in 25.04-BETA.1 that are being resolved in a future TrueNAS release. From 80de272dd4255f0c45d5f1389bf96369c2fe3bb6 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 10:40:25 -0500 Subject: [PATCH 18/25] Update words-to-ignore.txt --- words-to-ignore.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/words-to-ignore.txt b/words-to-ignore.txt index b897584fa8..dd6d4ff36b 100644 --- a/words-to-ignore.txt +++ b/words-to-ignore.txt @@ -2192,3 +2192,4 @@ WidgetEditorAddNew WidgetEditorExistingWidget scrollbars DashboardMainHAScreen +Jellyfin From 6808b6e72e0fb58c9f9851e22e25c28b9cd865b4 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 11:37:19 -0500 Subject: [PATCH 19/25] Add config restrictions --- content/GettingStarted/Configure/UIConfigurationSCALE.md | 4 +++- static/includes/ConfigRestrictions.md | 5 +++++ static/includes/DownloadSystemConfigFileSCALE.md | 4 ++++ 3 files changed, 12 insertions(+), 1 deletion(-) create mode 100644 static/includes/ConfigRestrictions.md diff --git a/content/GettingStarted/Configure/UIConfigurationSCALE.md b/content/GettingStarted/Configure/UIConfigurationSCALE.md index ab2f6f8822..6c81e45c6a 100644 --- a/content/GettingStarted/Configure/UIConfigurationSCALE.md +++ b/content/GettingStarted/Configure/UIConfigurationSCALE.md @@ -146,7 +146,9 @@ After completing your initial system configuration and before you begin day-to-d 1. Saving the [system configuration file]({{< relref "SetUpBackupSCALE.md" >}}). 2. Saving or [creating a new boot environment]({{< relref "ManageBootEnvironSCALE.md" >}}) to use as a restore point if system issues cause you to lose access to the TrueNAS UI. 3. Downloading a system debug to capture system information to use as a comparison against future debug files. - To download a system debug file, go to **System > Advanced Settings** and click **Save Debug** to begin the download. + {{< expand "Downloading a system debug file" "v" >}} + {{< include file="/static/includes/DownloadSystemConfigFileSCALE.md" >}} + {{< /expand >}} Keep both the system configuration file and the initial system debug file in a safe location where important files are regularly backed up. You can use the boot environment in an SSH session to restore your system to the point where you completed your system configuration, and then import data or pools to recover stored data. diff --git a/static/includes/ConfigRestrictions.md b/static/includes/ConfigRestrictions.md new file mode 100644 index 0000000000..9b0bffe5bc --- /dev/null +++ b/static/includes/ConfigRestrictions.md @@ -0,0 +1,5 @@ + + +In TrueNAS 25.04 (and later), users must log in as a system administrator with full administrative access to upload or download a system configuration file. +Other users, including restricted admin accounts such as a shares administrator, cannot perform database operations. +See [Using Administrator Logins]({{< ref "/scaletutorials/credentials/adminroles.md" >}}) for more information on admin account types. diff --git a/static/includes/DownloadSystemConfigFileSCALE.md b/static/includes/DownloadSystemConfigFileSCALE.md index 6e2db6a489..6425c59918 100644 --- a/static/includes/DownloadSystemConfigFileSCALE.md +++ b/static/includes/DownloadSystemConfigFileSCALE.md @@ -1,5 +1,9 @@ +{{< hint type=info title="System Admin Required" >}} +{{< include file="/static/includes/ConfigRestrictions.md" >}} +{{< /hint >}} + When you download the configuration (config) file, you have the option to include encrypted passwords in the config file. Select **Export Password Secret Seed** to download this file. Downloading both the config file and the secret seed file allows you to restore the system to a different operating system device where the decryption seed is not already present. From 7ff551e61cff165999c2acc6a03214ab2ca0bc31 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 11:37:22 -0500 Subject: [PATCH 20/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 6ca1ae6019..ac73573709 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -60,6 +60,8 @@ More details are available from [Software Releases](https://www.truenas.com/docs * {{< include file="/static/includes/APIKeyMigrate.md" >}} +* {{< include file="/static/includes/ConfigRestrictions.md" >}} + * The default libvirt account UID and GID is changed to to avoid possible clashes with user created Active Directory (AD) users. TrueNAS automatically updates libvirt UID and GIDs when upgraded to 25.04. Users attempting revert to 24.10 or an earlier release must manually review and update libvirt-qemu user and group IDs back to the values that were default in that version (64055:64055 for 24.10). ### Migrating Virtual Machines From 77538f93c5042e13b4f7bf4b01163f52f072cec6 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 12:36:06 -0500 Subject: [PATCH 21/25] Update words-to-ignore.txt --- words-to-ignore.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/words-to-ignore.txt b/words-to-ignore.txt index dd6d4ff36b..38c9cfcb89 100644 --- a/words-to-ignore.txt +++ b/words-to-ignore.txt @@ -2193,3 +2193,4 @@ WidgetEditorExistingWidget scrollbars DashboardMainHAScreen Jellyfin +ConfigRestrictions From 28147ac9c19d680e959382952473f213809f2e50 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 12:40:07 -0500 Subject: [PATCH 22/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index ac73573709..1d63484056 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -167,5 +167,4 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp * `PCI_SLOT` is the pci slot identified in the error, for example "0000:2d:00.0”. * `GPU_UUID` is the UUID matching the pci slot that you retrieved with the above command. - Click here to see the latest information about public issues discovered in 25.04-BETA.1 that are being resolved in a future TrueNAS release. From 0d0a0fb43014e9ccdbb96e1431332cbf560e95a2 Mon Sep 17 00:00:00 2001 From: DjP-iX <133042991+DjP-iX@users.noreply.github.com> Date: Wed, 12 Feb 2025 16:44:24 -0500 Subject: [PATCH 23/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 1d63484056..21d83ee671 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -1,13 +1,13 @@ --- -title: "25.04 (Fangtooth) Development Notes" -description: "Highlights, change log, and known issues for the latest TrueNAS nightly development version." +title: "25.04 (Fangtooth) Version Notes" +description: "Highlights, change log, and known issues for TrueNAS 25.04 release versions." weight: 10 related: false --- {{< header logo="/images/tn-openstorage-logo.png" logo_alt="TrueNAS Logo" version="25.04 Fangtooth" icon="" icon_alt="" >}} -{{< 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). +{{< hint type="tip" title="25.04 Early Release Documentation" >}} +This page tracks the latest development roadmap and early release notes for the future TrueNAS major version 25.04 (Fangtooth). 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 >}} From bd39b694beb0d904aa7bb42dd4c982f52ee7e8bf Mon Sep 17 00:00:00 2001 From: Tim Moore Date: Thu, 13 Feb 2025 09:17:09 -0500 Subject: [PATCH 24/25] Update UIConfigurationSCALE.md --- .../GettingStarted/Configure/UIConfigurationSCALE.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/content/GettingStarted/Configure/UIConfigurationSCALE.md b/content/GettingStarted/Configure/UIConfigurationSCALE.md index 6c81e45c6a..48a2169bcf 100644 --- a/content/GettingStarted/Configure/UIConfigurationSCALE.md +++ b/content/GettingStarted/Configure/UIConfigurationSCALE.md @@ -144,11 +144,13 @@ See [Managing SMART Tests]({{< relref "SmartTestsScale.md" >}}) for information After completing your initial system configuration and before you begin day-to-day operations, we recommend configuring the system and data storage backup. Recommended backup options: 1. Saving the [system configuration file]({{< relref "SetUpBackupSCALE.md" >}}). -2. Saving or [creating a new boot environment]({{< relref "ManageBootEnvironSCALE.md" >}}) to use as a restore point if system issues cause you to lose access to the TrueNAS UI. -3. Downloading a system debug to capture system information to use as a comparison against future debug files. - {{< expand "Downloading a system debug file" "v" >}} - {{< include file="/static/includes/DownloadSystemConfigFileSCALE.md" >}} - {{< /expand >}} + {{< expand "Downloading a system config file" "v" >}} + {{< include file="/static/includes/DownloadSystemConfigFileSCALE.md" >}} + {{< /expand >}} +3. Saving or [creating a new boot environment]({{< relref "ManageBootEnvironSCALE.md" >}}) to use as a restore point if system issues cause you to lose access to the TrueNAS UI. +4. Downloading a system debug to capture system information to use as a comparison against future debug files. + To download a system debug file, go to **System > Advanced Settings** and click **Save Debug** to begin the download. + Keep both the system configuration file and the initial system debug file in a safe location where important files are regularly backed up. You can use the boot environment in an SSH session to restore your system to the point where you completed your system configuration, and then import data or pools to recover stored data. From 4b4b8850642fb750019154a13f7b73d3b91dc576 Mon Sep 17 00:00:00 2001 From: Tim Moore Date: Thu, 13 Feb 2025 10:55:48 -0500 Subject: [PATCH 25/25] Update SCALEReleaseNotes.md --- content/GettingStarted/SCALEReleaseNotes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md index 21d83ee671..9ad09f4e07 100644 --- a/content/GettingStarted/SCALEReleaseNotes.md +++ b/content/GettingStarted/SCALEReleaseNotes.md @@ -136,7 +136,7 @@ This first public release version of TrueNAS 25.04 (Fangtooth) has software comp * 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)). * UI login experience improvements ([NAS-130810](https://ixsystems.atlassian.net/browse/NAS-130810)). * NFS over RDMA support - Enterprise Feature ([NAS-131784](https://ixsystems.atlassian.net/browse/NAS-131784)). -* iSCSI Extensions for RDMA (iSER) support ([NAS-106190](https://ixsystems.atlassian.net/browse/NAS-106190)). +* iSCSI Extensions for RDMA (iSER) support - Enterprise Feature ([NAS-106190](https://ixsystems.atlassian.net/browse/NAS-106190)). * ZFS Fast deduplication support ([NAS-127088](https://ixsystems.atlassian.net/browse/NAS-127088)). * iSCSI and ZVOL block cloning support ([NAS-130017](ixsystems.atlassian.net/browse/NAS-130017)). * Incus Container & VM Support - Experimental Community Feature ([NAS-130251](https://ixsystems.atlassian.net/browse/NAS-130251)).