Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FreeNAS - Update FreeNAS - Update FreeNAS to TrueNAS ======

===== Pre-cursor =====

  * Check if on latest version of current release.
    * Check for updates.  E.g. 11.  No updates available.
  * 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, just in case.
  * 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.  Just as a precaution.
  * Take a backup of system configuration.  Navigate to **System -> General**.  Click **Save Config**.


----

===== Do the Upgrade =====

Navigate to the **Dashboard**, and click on the **Check for Update** option within **System Information**.

{{:freenas:update_freenas:freenas_-_system_information_-_check_for_updates.png?600|}}

displays:

{{:freenas:update_freenas:freenas_-_check_for_updates.png?800|}}

<WRAP info>
**NOTE:**  Notice that it states **No updates available.**

This informs that there are no updates available against the current version 11 branch.

If there are updates available under this version 11 branch, it is recommended to first update to the most recent version, before continuing with the upgrade to TrueNAS.

</WRAP>


Now check what update options are available, by clicking the down-down arrow:

{{:freenas:update_freenas:freenas_-_check_for_updates_-_list.png?800|}}

Select the STABLE release.

{{:freenas:update_freenas:freenas_-_check_for_updates_-_select_truenas_release_to_upgrade_to.png?800|}}

This prompts to Switch Train.  

{{:freenas:update_freenas:freenas_-_check_for_updates_-_select_truenas_release_to_upgrade_to_-_switch_train_-_confirmed.png?400|}}

Check the Update Information and read the Release Notes:

{{:freenas:update_freenas:freenas_-_update_-_information_release_notes.png?800|}}


Click **Download Updates**.

Save the Configuration.

{{:freenas:update_freenas:freenas_-_update_-_save_configuration.png?800|}}


Download the Update:

{{:freenas:update_freenas:freenas_-_update_-_download_update.png?800|}}


This will download the updates:

{{:freenas:update_freenas:freenas_-_update_-_downloading.png?600|}}

and will then install the updates:

{{:freenas:update_freenas:freenas_-_update_-_installing.png?400|}}

The system will automatically reboot a number of times.

Eventually, when done, Log back in.

{{:freenas:update_freenas:truenas_-_login.png?400|}}

It will display an introductory help message:

{{: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 Alerts =====

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|}}


----

===== Backup =====

It is recommended to take a full backup of the system again which will be on the 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.