System migration

This manual describes how to migrate an active IACBOX system onto a new hardware or VM.

Creating a backup

Before migrating a system, a backup must be downloaded. This can be done at any given time in the WebAdmin menu System/Backup. The backup contains the following data:

  • Users and Tickets
  • Ticket templates
  • System configuration
  • Login pages with customizations
  • License information

Now that this data has been saved, the backup can be uploaded on a new IACBOX system by using the same WebAdmin menu, System/Backup - Restore.

Migrating to new hardware

When migrating to new hardware, the same IACBOX main version of the base system has to be installed on the new hardware. For example, if the base system is running on version 21.0.21004 (p21280), then version 21.0.21004 must be installed on the new hardware. This will ensure compatibility between the backups from either system.

After the same version was installed on the new hardware, a backup from the base system can now be applied on the new system.

  • Backups will also restore license information from the base system - if both systems are running simultaneously with the same license, then the license becomes invalid.
  • After changing hardware, the IACBOX license must be unlocked in the Partner Portal. Therefore find the according license in the list of all your licenses and right click on it to find the Unlock License menu entry. After unlocking a license, it can be registered on new hardware.

Migrating to a new version

There are a handful of reasons why the IACBOX must be reinstalled:

  • The system administrator wants to migrate to a brand new IACBOX version which is not available via Online Update yet.
  • The initial installation was performed with a 32-bit release and does not receive any new updates. 32-bit hardware is not supported anymore.
  • Special cases where the automatic upgrade to a new version can’t be done automatically. This can happen in rare cases with BIOS RAID emulations.

After the installation image (ISO, USB) of the new version was obtained from our homepage or the Partner Portal, create a bootable medium and download a backup of the existing system. Now install the new version of the system according to the IACBOX Installation manual.

After the installation has finished, navigate into the WebAdmin menu System/Backup of the freshly installed system and restore the backup, which was created on the old system. After the backup has been applied, the system will perform an automatic reboot.

Migrating to version 17.2.11676

This version is special as 17.2 is the first full 64-bit version.

The brandnew IACBOX version 17.2.11676 was designed to be compatible with backups from version 17.0.11166 (p11450). System administrators can install the new version 17.2.11676 and simply restore a backup from a fully updated version 17.0, which then will work out of the box.

  • This will only work with backups from fully updated version 17.0.11166 systems with a patchlevel p11450. Backups from earlier versions can not be used.
← Firewalls: Required ports
Unattended Setup →