uDocs Unicon™

Migration from IGEL OS 11 to eLux® 7

Igel2eLux provides you with an easy-to-use tool to migrate your IGEL OS 11 endpoints and run the lean and secure operating system eLux 7.

The migration can be done fully automatically by distributing and running the tool centrally via the Universal Management Suite (UMS) or by accessing the tool from a network location.

When you execute igel2elux.sh, a new partition is created on the local hard drive. From this partition, the migration process is started and the eLux 7 operating system defined by the image is installed.

Downloading the software

  • Sign in to the myelux.com portal.
  • In the Products & Downloads section, select Tools and then Migration tools
  • Download the latest igel2elux .zip file.

Requirements

  • The tool igel2elux.sh needs to run as root (remotely or in a terminal window)

How to run

  • Distribute the tool as a ZIP file on the Igel endpoints or on a network drive
  • Extract the package on the endpoint
  • Run the tool on the endpoint, using the parameters that suits your requirements

Once executed, Igel2eLux will perform the installation of eLux by using the image location that has been provided. No user interaction is needed.

After successful installation, eLux will boot and the endpoint can be onboarded as usual. If an issue is found, the tool will exit.

Parameters for igel2elux.sh

The syntax for igel2elux.sh: igel2elux.sh --url <URL> OPTIONAL_PARAMETERS

Parameter Info Description
–url Required Points to the relevant software container and the image definition file (IDF) which specifies the scope of the installation
–log   Specifiy a log file for the output of this tool, e.g. migration.log
    You can also use a network drive for ensuring a persistent log file
    By default, the log file igel2elux.log is created in the same directory as the igel2elux tool
–proxy   Specify a proxy address, e.g. 1.1.1.1
–port   Specify a port number for the proxy, e.g. 8090
–noreboot   If the parameter is given, the endpoint will not reboot after the installation
    If the noreboot option is used, the migration will not start automatically, but on the next boot
–debug   Verbose installation messages in the console output
    Stops in error situations and shows error messages for different cases
    Without the parameter, the device will restart in case of an error without showing an error message

Examples

Example-1: Migrate the IGEL OS 11 endpoint to the given eLux image and reboot

Syntax: bash igel2elux.sh --url http://images.citrix.com/elux/myimage.idf

Example-2 Migrate the IGEL OS 11 endpoint to the given eLux image, write a log file, use a proxy and don’t reboot

Syntax: bash igel2elux.sh --url http://images.citrix.com/elux/myimage.idf --log migration.log --proxy http://proxy.citrix.com --port 8888 --noreboot

Note:

The migration is possible with or without secure boot or a bitlocker

Migration from IGEL OS 11 to eLux® 7