From JumpBox Documentation Wiki

Upgrade to a Newer Version of the JumpBox

When a new version of a JumpBox comes out, you may want to migrate your data into it to take advantage of new application features, enhancements to the JumpBox platform or security fixes. In some cases, new JumpBox releases contain critical security updates to both the application and the JumpBox, so upgrading is strongly encouraged. A JumpBox can be upgraded one of two ways:

• Restore from latest backup - create a backup of your existing JumpBox, download the latest version and then use the restore feature to inject your data into the newer version.
• JumpBox to JumpBox Migration - use the JumpBox-to-JumpBox migration feature to simply suck the data out of an older running JumpBox into the newer one.

Important: During the upgrade processes on most JumpBoxes your application data is automatically updated to work with the new version of the application. In some cases there are a few manual steps that you have to perform. These extra steps are typically documented on the application wiki page or in README.txt included with the JumpBox download.

Note: The following procedure only works when both JumpBoxes are versions 1.1.0 or greater. When the older JumpBox is 1.0, you can use the NFS or Windows Share restore methods.

Using the JumpBox backup and restore method or JumpBox to JumpBox Migration tool are the only update methods supported by JumpBox at this time.

JumpBox to JumpBox Migration Method

This tutorial will demonstrate the JumpBox to JumpBox Migration method. During this process you will have two JumpBoxes running at the same time.

1. Make sure you've downloaded and configured the latest version of the JumpBox application you're upgrading. Click the "Backups" icon in the admin portal.

2. Navigate to the "Restore" tab.

3. You'll need to have your older version of the JumpBox running somewhere on the same network.

4. Next you'll choose the "Import" option on the restore page and enter the location of the older JumpBox from which you wish to pull the data. Click "Restore" and provided that you've specified the credentials of a running JumpBox on your LAN, you should see a success message indicating that your data has been restored.

NOTE: this is a pull operation- you're in the new JumpBox "sucking" the data out of the older one. If you get confused here and think you're in the older one "pushing" data to the new version, you may overwrite your data. It's always a good idea to do a quick backup on the old version before you do anything that's potentially destructive.

Unsupported Methods

It is possible to use the Ubuntu tools (apt-get) to update the packages that come directly from Ubuntu and then manually update the application package from the application site itself. If you do this, however, there is no guarantee that the integration between the application and the JumpBox utilities will continue to work. You may choose this route if you are willing to accept that you are deviating from how JumpBoxes are intended to work and JumpBox support staff will no longer be able to assist you with problems. If you find yourself choosing this route, you might consider using the LAMPd or LAPPd JumpBox as a starting point.