Upgrading TrueNAS/FreeNAS Plugin Jail to Match System Release

When I update a TrueNAS/FreeNAS plugin jail, I encounter the following error,

Updating Plugin

Error: Major ABI change detected, please run 'upgrade' instead. 

The screen shot is below

After some research on the truenas forum, I have gotten a sense what's going on. 

1. First, let's be sure what TrueNAS/FreeNAS release that we are on by issuing the uname -r command, e.g.,
   

   
   TrueNAS $ uanme -r
   12.2-RELEASE-p10
   TrueNAS $
       

2. Second, let's list the plugins. For this, we need to open a TrueNAS/FreeNAS shell, and issue iocage list, e.g.,
   

   
   TrueNAS $ iocage list
   +------+-----------------+-------+--------------+--------------+
   | JID  |      NAME       | STATE |   RELEASE    |    IP4       |
   +======+=================+=======+==============+==============+
   | 4    | calibre         | up    | 11.2-RELEASE | DHCP         |
   +------+-----------------+-------+--------------+--------------+
   | 5    | nextcloud       | up    | 12.2-RELEASE | 198.51.100.1 |
   +------+-----------------+-------+--------------+--------------+
   | 7    | plexmediaserver | up    | 12.2-RELEASE | DHCP         |
   +------+-----------------+-------+--------------+--------------+
   
   TrueNAS $
     

   where we can see that the jail of plugin calibrehas a different system release number.
3. Then, upgrade the jail's release using the iocage upgrade command, e.g.,
   

   
   TrueNAS $ iocage upgrade calibre -r 12.2-RELEASE
       ...
   TrueNAS $
   

Updating Plex Media Server Plugin from FreeNAS 11.2-RELEASE to 11.3-RELEASE

 Plex failed to update when I upgrade FreeNAS from 11.2-RELEASE to 11.3-RELEASE. After some Web searches, I found the solution given in this post worked. For convenience, I copied the solution to this post in the following,

1. Stop the plex jail
2. Log on to a FreeNAS shell, and renamed the jail
   

   
       iocage rename plex plexmediaserver
       

3. From the FreeNAS shell, go into /mnt/__YOUR_STORAGE__/iocage/jails/plexmediaserver/ and renam plex.json to plexmediaserver.json,
   

   
       mv plex.json plexmediaserver.json
       

4. Open config.json in the same directory and change the plugin name from plex to plexmediaserver
5. Start the jail again. Everything still worked and both jail and plugin now displayed as plexmediaserver
6. Run the following command to upgrade the jail and the plex plugin
   

   
       iocage upgrade plexmediaserver -r 11.3-RELEASE
       

Updating Plex Media Server to Latest FreeNAS Plugin on Command Line in Jail

There are two methods to upgrade Plex Media Server in FreeNAS Jail. 

1. Method 1. Upgrading Plex Media Server to Latest FreeBSD Release. Using this method, you don't have to wait for FreeNAS developers to upgrade Plex Media Server in the plugin repository.
2. Method 2. Upgrading Plex Media Server to Latest FreeNAS Plugin. 

This post is about Method 2, and documents the steps to upgrade Plex Media Server on Command Line.

1. Login or open FreeNAS shell
2. List jails
   

   
   $ jls
   

   
   The output looks like the following
   

   
   $ jls
      JID  IP Address  Hostname     Path
        1              plex         /mnt/Storage/iocage/jails/plex/root
   $

3. Open a shell inside the jail. The command is as follows,
   

   
   jexec ${JID} csh
   

   
   In the above, the jail ID (JID) is 1. Since we can only the csh as root, we open a shell inside the jail as follows

   
   $ sudo jexec 1 csh
   

4. Upgrading the plexmediaserver package. Inside the jail, we do
   

   
   # pkg upgrade plexmediaserver
   

   
   If the installed version is already latest, we should observe something similar to the following,
   

   
   root@plex:/ # pkg upgrade plexmediaserver
   Updating iocage-plugins repository catalogue...
   iocage-plugins repository is up to date.
   All repositories are up to date.
   Checking integrity... done (0 conflicting)
   Your packages are up to date.
   root@plex:/ #
   

   
   However, if there is a newer version, the upgrade will commerce.
   
   
5. Restart Plex Media Server if it gets upgraded as follows inside the jail,
   

   
   # service plexmediaserver restart