diff --git a/static/includes/SCALEUpgradePaths.md b/static/includes/SCALEUpgradePaths.md index bf3634d670..b46112d069 100644 --- a/static/includes/SCALEUpgradePaths.md +++ b/static/includes/SCALEUpgradePaths.md @@ -46,12 +46,12 @@ The chart below shows recommended paths for upgrading from earlier TrueNAS versi Update the system to the latest maintenance release of the installed major version before attempting to upgrade to a new major version. Permitted upgrade methods are: -* **update**: apply an automatic update using the **Update** screen in the TrueNAS UI or install a manual update file. -* **ISO install**: save a current TrueNAS configuration file, perform a fresh install using an .iso file for the target version, and then upload the previously-saved configuration. +* **update**: apply an automatic update using the **Update** screen in the TrueNAS UI or install a manual update file. Some upgrade paths do not support these options (see chart). +* **ISO install**: save a current TrueNAS configuration file, perform a fresh install using an .iso file for the target version, and then upload the previously saved configuration. Users can skip major versions with a fresh ISO install followed by a configuration file upload. -However users migrating from an earlier version should carefully review release notes for each skipped major version, noting any service deprecations or significant changes that impact aspects of the previous configuration. -Consider stopping at major versions with significant impact to address changes before continuing to upgrade or expect to manually reconfigure incompatibilities on the latest target version. +Carefully review release notes for each skipped major version before upgrading, noting any service deprecations or significant changes that impact the previous configuration. +Consider stopping at major versions with significant impacts to address changes before continuing the upgrade path or be prepared to manually reconfigure incompatibilities on the latest target version.
@@ -61,7 +61,7 @@ Consider stopping at major versions with significant impact to address changes b {{< mermaid class="mermaid_sizing" >}} flowchart LR A["11.3-U5"] -->|update| B["12.0-U8.1"] - B -->|update| C["13.0-U6.3
13.3-U1"] + B -->|"update

ISO install"| C["13.0-U6.3

13.3-U1"] C -->|ISO install| H C -->|"(anticipated)"| I D["22.02.4 (Angelfish)"] -->|update| E