Differences

This shows you the differences between two versions of the page.

--- freenas:update_freenas:update_freenas_to_truenas [2020/11/13 14:07] – peter
+++ freenas:update_freenas:update_freenas_to_truenas [2021/01/25 09:29] (current) – [Check Alerts] peter
@@ Line 7: / Line 7: @@
   * Check if Pools are Healthy, do not need re-silvering and are online.
     * If Pools do need remediation then do this prior to upgrading.
-  * Backup of the actual data taken, just in case.
+  * Backup of the actual data, just in case.
-  * Check services and ensure they are running.
+  * Check services and ensure they are running okay.
   * Ensure Plugins and Jails are running okay.
   * Ensure Virtual machines are running okay.
-    * Stop any running Virtual machines.
+    * Stop any running Virtual machines.  Just as a precaution.
-  * Take a backup of system configuration.  Navigate to **System -> General**.
+  * Take a backup of system configuration.  Navigate to **System -> General**.  Click **Save Config**.
@@ Line 41: / Line 41: @@
 {{:freenas:update_freenas:freenas_-_check_for_updates_-_list.png?800|}}
-We select the STABLE release.
+Select the STABLE release.
 {{:freenas:update_freenas:freenas_-_check_for_updates_-_select_truenas_release_to_upgrade_to.png?800|}}
@@ Line 78: / Line 78: @@
 Eventually, when done, Log back in.
-[todo - put login screenshot]
+{{:freenas:update_freenas:truenas_-_login.png?400|}}
 It will display an introductory help message:
@@ Line 84: / Line 84: @@
 {{:freenas:update_freenas:truenas_-_looking_for_help.png?800|}}
+  * [[https://www.truenas.com/docs/|TrueNAS Documentation Site]]
+  * [[https://www.ixsystems.com/community/|TrueNAS Community Forum]]
+Click **Get Started**.
 ----
-CHECK
+===== Check Alerts =====
-UPGRADE POOL
+Check any alerts:
+{{:freenas:update_freenas:truenas_-_alerts.png?800|}}
+<WRAP info>
+**NOTE:**  The top message mentions about new ZFS features that affect Pools.
+The other message shown here is around Plex Jail update.
+These will both be updated in the next steps.
+</WRAP>
+----
+===== Upgrade Pool =====
+Navigate to **Storage -> Pools**.
+Click the Gears icon and select **Upgrade Pool**.
+{{:freenas:update_freenas:truenas_-_storage_-_pools_-_upgrade_pool.png?1200|}}
+Take head of the warning:
+{{:freenas:update_freenas:truenas_-_storage_-_pools_-_upgrade_pool_-_warning.png?800|}}
+<WRAP important>
+**WARNING**:  This is one way.
+Once the upgrade is done then the Pool cannot be used with the old FreeNAS version.
+</WRAP>
+This will confirm the Pool has been upgraded.
+{{:freenas:update_freenas:truenas_-_storage_-_pools_-_upgrade_pool_-_upgraded.png?800|}}
+----
+===== Upgrade Jails =====
+Take snapshot first, from Pools.
+  * Navigate to **Storage -> Pools**.
+  * Expand the **iocage** to show the **Jails**.
+  * Select the **Create Snapshot** option by clicking the 3 dots to right-side of the **jails** filesystem.
+{{:freenas:update_freenas:truenas_-_storage_-_pools_-_jails_-_create_snapshot.png?800|}}
+----
+Navigate to **Jails**.
+Select the Jail to update and click the **Update** button:
+{{:freenas:update_freenas:truenas_-_jails_-_update.png?800|}}
+Confirm the update:
+{{:freenas:update_freenas:truenas_-_jails_-_update_-_confirmation.png?600|}}
+If the update is Successful, then check that the actual version number showing against the Jail is definitely version 12 or higher, as appropriate for TrueNAS.  If not then follow on with the next steps here too.
+{{:freenas:update_freenas:truenas_-_jails_-_update_-_error_-_major_change.png?800|}}
+<WRAP info>
+**NOTE:** This shows that the update failed as a full Upgrade of the Jail is needed.
+This Full Upgrade will be done through the shell.
+</WRAP>
+Navigate to the **Shell** menu.
+Type "iocage fetch".
+{{:freenas:update_freenas:truenas_-_shell_-_iocage_fetch.png?800|}}
+<WRAP info>
+**NOTE**: This will display all available versions.
+Per the above screenshot, option 5 seems to be the most recent, so select this option.
+</WRAP>
+Entering the Option that is wanted, 5 in this case will then do the upgrade:
+{{:freenas:update_freenas:truenas_-_shell_-_upgrade.png?800|}}
+<WRAP info>
+**NOTE:**  See the comment at the bottom saying to run **/tmp/tmpo3jtkmjr fetch**.
+Try to run this.  No worries if this does not run.
+</WRAP>
+Upgrade Plex, by typing **iocage upgrade -r 12.2-RELEASE PlexServer**:
+{{:freenas:update_freenas:truenas_-_jails_-_plex_-_update.png?800|}}
+<WRAP info>
+**NOTE**:  You may find that version 12.2 of the Jails is not found.
+If so then try a previous version, such as 12.1 by typing **iocage upgrade -r 12.1-RELEASE PlexServer**
+</WRAP>
+Verify that the Jail is on the latest release:
+{{:freenas:update_freenas:truenas_-_jails_-_plex_-_latest_release.png?800|}}
+Navigate to **Jails**.
+Select the Jail to update and click the **Update** button:
+{{:freenas:update_freenas:truenas_-_jails_-_update.png?800|}}
+----
-UPDATE JAILS
+===== Backup =====
-  * Take snapshot first, from Pools.
-  * Try update through option under GUI Jail menu.
-    * If not moved to version 12, then need to use command line:
-      * Type "iocage fetch"
-      * Choose option to move to
-      * Type "iocage upgrade -r 12.1-RELEASE PlexServer
-        * where PlexServer is the name of the Jail
-      * Does this look reasonable prompts - enter Y
-      * If you get asked to run something like "/tmp/xyz" then do so.
-  * Start Jail through GUI.
-  * Go to Shell, using option under the actual Jail.
-    * Type "htop" to check if running.
-    * Type "exit".
-  * Check Jail version is now updated.
+It is recommended to take a full backup of the system again which will be on the new version.
-BACKUP system which is on new version.
+If a restore were needed going forward, the backup would already be on this version, otherwise you may need to have to repeat the full upgrade process again, if using an older backup.