Table of Contents
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.
displays:
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.
Now check what update options are available, by clicking the down-down arrow:
Select the STABLE release.
This prompts to Switch Train.
Check the Update Information and read the Release Notes:
Click Download Updates.
Save the Configuration.
Download the Update:
This will download the updates:
and will then install the updates:
The system will automatically reboot a number of times.
Eventually, when done, Log back in.
It will display an introductory help message:
Click Get Started.
Check Alerts
Check any alerts:
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.
Upgrade Pool
Navigate to Storage → Pools.
Click the Gears icon and select Upgrade Pool.
Take head of the warning:
WARNING: This is one way.
Once the upgrade is done then the Pool cannot be used with the old FreeNAS version.
This will confirm the Pool has been upgraded.
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.
Navigate to Jails.
Select the Jail to update and click the Update button:
Confirm the update:
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.
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.
Navigate to the Shell menu.
Type “iocage fetch”.
NOTE: This will display all available versions.
Per the above screenshot, option 5 seems to be the most recent, so select this option.
Entering the Option that is wanted, 5 in this case will then do the upgrade:
NOTE: See the comment at the bottom saying to run /tmp/tmpo3jtkmjr fetch.
Try to run this. No worries if this does not run.
Upgrade Plex, by typing iocage upgrade -r 12.2-RELEASE PlexServer:
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
Verify that the Jail is on the latest release:
Navigate to Jails.
Select the Jail to update and click the Update button:
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.