Upgrade FreeNAS 9.x to 11.x using web console

For my Oracle RAC deployments I use FreeNAS to provide shared storage to my cluster nodes. In this blog post I will show, how to upgrade an existing FreeNAS 9.x installation to an 11.x release.

Upgrade Methods

There are different ways to upgrade a FreeNAS installation. I will use the web console approach in this blog post. Apart from that, an ISO file can be used for the upgrade.

Caution with FreeNAS 11.3

The current version of FreeNAS is 11.3-U3, which can be downloaded here. In my first attempt I used this release as my upgrade target. The upgrade itself went smoothly, but the reboot of the server hangs at the following step:

middlewared: setting up plugins (pwenc) [2/35]

After waiting a long time the prompt appears, but the server is not functional. Accessing the web console throws the following error. JIRA ticket https://jira.ixsystems.com/browse/NAS-104813 explains this issue in more detail.

Web Console Error after Upgrade

With FreeNAS 11.2-U8 everything works fine. I will use this version to demonstrate the upgrade process.

Save Configuration

This step is optional but recommended. Saving the current FreeNAS configuration allows a quicker recovery for the case that the upgrade fails.

Navigate to System > General and press the button Save Config to save the current configuration to your local machine.

Perform Upgrade

After logging into the web console, navigate to the System menu item and open to the Update tab afterward.

Update Menu of FreeNAS

As default the train (update stream) belonging to the installed release is selected to search for new updates. To upgrade FreeNAS select the target version and confirm the prompt with Yes.

FreeNAS Update Trains
Confirmation Prompt after changing Train

After pressing the Check Now button, the list of available upgrade packages is displayed.

List of Upgrade Packages

Enable the checkbox to automatically install the updates after the download and press OK to start the upgrade. The FreeNAS server is automatically rebooted after the upgrade.

After the reboot of the server the new web console is accessible. On the dashboard the upgraded version is also visible.

New FreeNAS Dashboard

Upgrade ZFS Pools

If ZFS pools already exist, all of them have to be upgraded to remove the following alert.

FreeNAS Alerts after the Upgrade

To do this navigate to Storage > Pools and run Upgrade Pool from the context menu for all existing ZFS pools.

Upgrade of ZFS Pools
Confirm the ZFS Pool Upgrade
Successful Upgrade of ZFS Pool

After all ZFS pools are upgraded, the alert will disappear.


Leave a Reply

Your email address will not be published.