Product documentation
uDocs Unicon™

Performing the migration

September 7, 2025
Contributed by: 
C

The migration from eLux® RP 6 to eLux 7 can be carried out easily via a firmware update. Below you will find details on the requirements and the procedure.

Prerequisites

  • The migration enablement 1.6.3-1 package or any newer version is available in the UC_RP6_X64 container and is defined in the current eLux RP 6 image.

  • The following migration files are available in the UC_ELUX7 container:

    -  `migrationfiles-<version>.tar.gz`
-  `migration-system-<version>.idf`
-  recovery_systemEFI.rdf
  • The eLux 7 target image (.idf) is defined in the UC_ELUX7 container and has the same name as the current eLux RP 6 image (.idf).
  • In the device configuration, the container variable __CONTAINER__ is specified for the firmware path.

Preparing the migration

The migration enablement package for eLux RP 6 required for migration and the migration files for eLux 7 are provided via a separate download link.

Web-based ELIAS 18

  1. Import the migration enablement package via ELIAS 18 into the eLux RP 6 Container UC_RP6_X64.
  2. Define the migration enablement package with activated FPM for the One Step Migration to the current eLux RP 6 image (.idf) in the UC_RP6_X64 container.
  3. Import the archive migration-package-<version>.zip into the container UC_ELUX7.

  4. Define the eLux 7 target image (.idf) in the UC_ELUX7 container.

    • The image should have the same name as the current eLux RP 6 image (.idf).
    • If a name other than the current eLux RP 6 image (.idf) is to be used for the eLux 7 target image (.idf), an Advanced file entry must be set before the migration:
           
    File Section Key Value
    /setup/terminal.ini UpdateInfo MigrationIdfUrl <URL>

    The URL must not contain the container variable __CONTAINER__ in the firmware path. Instead, the container name must be specified. *Example: https://MyWebServ.domain.com/elias/container/UC_ELUX7/MyImage.idf

Legacy ELIAS

  1. Import the migration enablement package via ELIAS into the eLux RP 6 Container UC_RP6_X64.
  2. Define the migration enablement package with activated FPM for the One Step Migration to the current eLux RP 6 image (.idf) in the UC_RP6_X64 container.
  3. Unzip the archive migration-package-<version>.zip and copy the migration files (migrationfiles-<version>.tar.gz, migration-system-<version>.idf, recovery_systemEFI.rdf) into the UC_ELUX7 folder.

  4. Define the eLux 7 target image (.idf) in the UC_ELUX7 container.

  5. The image should have the same name as the current eLux RP 6 image (.idf).

  6. If a name other than the current eLux RP 6 image (.idf) is to be used for the eLux 7 target image (.idf), an Advanced file entry must be set before the migration:

           
    File Section Key Value
    /setup/terminal.ini UpdateInfo MigrationIdfUrl <URL>

    The URL must not contain the container variable __CONTAINER__ in the firmware path.Instead, the container name must be specified. *Example: https://MyWebServ.domain.com/eluxng/UC_ELUX7/MyImage.idf

Important:

The migration files must not be changed manually.

The devices must not be switched off during the migration.

Devices should be connected via LAN, WLAN, VPN und IEEE 802.1X during the migration. Using WWAN connections (i.e. LTE) is not supported. During the migration via VPN the VPN-connection needs to be reconnected after each reboot.

Please do not use the firmware settings “Check for new image version on start / on shutdown” during the migration process.

This can lead to an incorrect device configuration (e.g. Citrix StoreFront application definition), which requires a remote factory reset.

Migration process

The migration is triggered by the installation of the migration enablement package with activated One Step Migration FPM on eLux RP 6, if the device fulfils the migration requirements for eLux 7.

The migration requirements to be checked are:

  • 8 GB HDD or more
  • 4 GB RAM or more
  • Boot Mode UEFI
  • eLux RP 6 versions: 2302 LTSR, 2209 CR, 2104 LTSR CU3, 2104 LTSR CU4

If the device does not meet the migration requirements, a new check is carried out each time the device is restarted as long as the migration enablement package is installed.

A system message informs the user that the migration is due in a few minutes. During the migration, an eLux 7 base image is installed first and the eLux 7 target image is installed automatically in a further step.

Note:

Once the migration is complete, it is no longer possible to downgrade to an eLux RP 6 version with the old partition layout using a firmware update. Please use PXE recovery or USB stick recovery if a downgrade is required.

Performing the migration
September 7, 2025
Contributed by: 
C
September 7, 2025
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.