====== FreeNAS - Jails - Upgrade a Jail ======

Before upgrading a Jail:

  * [[FreeNAS:Jails:Update a Jail to latest Patch Release|Update the Jail to the latest Patch Release]]
  * [[FreeNAS:Jails:Take a Snapshot|Take a Snapshot]]

----

===== Upgrade the Jail =====

Stop the Jail.

Open the Shell.

<code bash>
iocage upgrade name -r release
</code>

where:

  * **name** is the plugin jail name; and 
  * **release** is the desired release to upgrade to.

----

===== Example =====

Determine what Releases are available:

<code bash>
iocage fetch
</code>

returns:

<code bash>
[0] 11.2-RELEASE (EOL)
[1] 11.3-RELEASE (EOL)
[2] 11.4-RELEASE
[3] 12.0-RELEASE (EOL)
[4] 12.1-RELEASE
</code>

----

Upgrade Plex:

<code bash>
iocage upgrade PlexServer -r 12.1-RELEASE
</code>

----

===== Upgrade all of the packages inside the Jail =====

When the upgrade is done, enter the jail:

<code bash>
sudo iocage console PlexServer
</code>

and run:

<code bash>
pkg update && pkg upgrade
</code>

returns:

<code bash>
Updating iocage-plugins repository catalogue...
iocage-plugins repository is up to date.
All repositories are up to date.
Updating iocage-plugins repository catalogue...
iocage-plugins repository is up to date.
All repositories are up to date.
Checking for upgrades (0 candidates): 100%
Processing candidates (0 candidates): 100%
Checking integrity... done (0 conflicting)
Your packages are up to date.
</code>

----

===== Verify the Upgrade has worked =====

<code bash>
sudo iocage list
</code>

returns:

<code bash>
+-----+------------+-------+--------------+------+
| JID |    NAME    | STATE |   RELEASE    | IP4  |
+=====+============+=======+==============+======+
| 4   | PlexServer | up    | 12.1-RELEASE | DHCP |
+-----+------------+-------+--------------+------+
</code>

----

===== Troubleshooting =====

If this error is seen:

<code bash>
pkg: repository meta /var/db/pkg/FreeBSD.meta has wrong version 2
</code>

try:

<code bash>
pkg bootstrap -f
</code>

----