Migration from Version 3.0 to 5.0

Applies to platform: All UTM 3.0, except for ARM
Updated on: 26th October 2016

This document lists the requirements and shows the steps to successfully upgrade your Endian UTM Appliance from the 3.0.5 to the 5.0 version. Since the 5.0 is a 64bits release based on a new platform, to complete the upgrade it is mandatory to reinstall the operating system and therefore to schedule a period of downtime of the appliance, whose length depends on the services to restore and the type of appliance.

UTM Appliances that can be upgraded

This is the full list of the UTM appliances that can be upgraded to EndianOS:

Mini 25, Mini 25 WiFi, Mercury 50, Mercury 100, Macro 250, Macro 500, Macro 1000, Macro 2500, Virtual, and Software.

For the following models: Mercury (2011 Edition), Macro X1 (2011 Edition) and Macro X2 (2011 Edition), the upgrade is available only if the serial number of the appliance is TSBxxxxxx.

Warning - Switchboard users:

Appliances with the Switchboard module installed can not be upgraded to 5.0 at the moment. Appropriate images will be released soon.


To be able to upgrade to 5.0, it is mandatory to have:

  1. A full up-to-date Endian Appliance 3.0 or 3.0.5, with all packages updated to their latest version.
  2. A valid maintenance.
  3. A valid Endian Network account.

System Requirements for Virtual and Software UTM Appliances

The minimum requirements to upgrade to the 5.0 are the following:

  1. CPU Intel x86_64 compatible / 1GHz Minimum (Dual-core 2 GHz Recommended).
  2. Multi-Processor Symmetric Multi-Processor (SMP) support included.
  3. RAM 2GB minimum (4 GB recommended).
  4. Hard Disk  8GB Minimum (20 GB Recommended)  Support for full virtualization and paravirtualization.
  5. CD-ROM Physical and virtual drives as supported by the hypervisor.
  6. Network Cards 2 Virtual NICs Minimum / Support for full virtualization and paravirtualization.
  7. Supported Hypervisors: Xen, Vmware, KVM, and Hyper-V.


All 3.2 virtual and software UTM appliances will be automatically upgraded to the 5.0.

The whole upgrade procedure is divided into two parts: A Preparation step and the Installation step.


Pay particular attention to the "switch channel" step: it is mandatory to carry it out after you installed the new version but before you import the 3.0's backup. If you forget to do so, you will not be able to install updates!

1. Preparation

The initial steps of the procedure are much like in the previous upgrades:

  1. Make a full update of the appliance, using the GUI (System > Updates) or issuing this command from the CLI:
    root@endian:~ # efw-update upgrade
  2. Make a full backup of the appliance, which can then be copied from the Endian appliance and saved in a safe place. This backup can be stored also for legal reasons, since it contains all of the data (configuration settings, database dump, all log files) present on the Endian appliance.
  3. Make a backup of the appliance which includes only the current settings and database dupms (options Current configuration and Include database dumps) and use this one as the backup to restore on the migrated appliance. This is suggested for several reasons: the whole procedure will bes quicker, since the least amount of data is being restored, resulting in shorter downtime, it will be less error-prone (in case the backup becomes corrupted for any reasons)
  4. (optional) If you have a virtual appliance, make a snapshot of the current state of the VM, to be restored if you experience problems during or after the installation.
  5. Download from the dedicated section on Endian Network the installation image corresponding to your model.
  6. Burn the image on an USB stick. Please refer to this article for directions on how to create such a USB stick.

2. Installation

Once you downloaded the installation image, these are the steps to be followed:

  1. If you have a hardware appliance (Mini, Mercury, Macro), make sure you boot it from the USB drive. To make sure the boot order is correct, please follow this howto.
  2. Start the installation process normally.
  3. Follow the instructions that appear on the screen.

Registration to Endian Network

After the successful installation, the appliance will reboot. At this point you should:

  1. Switch channel: Go to Endian Network and upgrade your system to the 5.0 using the button that will be displayed next to your appliance's data.


    The button will not show up in Endian Network, if the appliance is not eligible for the update or if there are updates to be installed.
  2. Import the backup to your appliance. The system will be automatically registered and will show the new version in the GUI.
  3. Update the appliance with the latest availbale packages.

At this point you have a full up to date Appliance equipped with latest 5.0 version. Enjoy!

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


  • Avatar
    Florian Klein
    Edited by Florian Klein