Skip to main content
Skip table of contents

How To Create, Distribute, and Manage Virtual Machines with the IGEL Managed Hypervisor (IMH)

Synopsis

The workflow from setup to operation can be divided into four steps:

  1. Create a golden virtual machine image on an IGEL OS 12 machine dedicated to this task (image creation machine)

  2. Capture the golden image and upload it to a WebDAV repository

  3. Configure the IGEL OS 12 endpoint devices on which the virtual machines will run

  4. Remotely manage and configure the virtual machines on the target machines via the UMS Web App

Prerequisites

Hardware

  • CPU

    • 64-bit capable

    • Dual Core or more

    • 1.5 GHz or more

    • CPU must be virtualization-enabled (Intel VT-x or AMD-V)

  • RAM: 8 GB minimum, 16 GB recommended

  • Storage

    • 128 GB or more; for virtual machines that run MS Windows 10 or MS Windows 11, the storage requirements may be higher

    • SSDs are strongly recommended

Environment / Infrastructure

UMS

  • Your UMS version is 12.08.100 or higher

  • Your UMS user has the following permissions (User Management area in the UMS Web App):

    • App management

    • Hypervisor management

image-20250729-065342.png

  • The image creation machine and all target machines are registered in the UMS

  • The app IGEL Managed Hypervisor 1.0.0 BUILD 1.0 is registered in the UMS

ISO Source

  • The image from which you want to create the Golden Image is available

WebDAV server

  • Your WebDAV server is set to use basic authentication

  • HTTPS should be used

  • Two users are configured:

    • 1 user with read permissions

    • 1 user with write permissions

  • The following servers can be used:

    • Apache

    • Nginx

    • Microsoft IIS; please note the following: Use the IIS manager to add the MIME type application/x-lz4 as described here: Adding Static Content MIME Mappings

    • If you want to roll out the VMs on about 15 or fewer devices, the built-in WebDAV server of the UMS might be sufficient.

IGEL OS Base System

  • IGEL OS Base System 12.7.1 PR 1 or higher is installed on the image creation machine and all target machines

Licenses

  • Your UMS has the IGEL Enterprise UMS license; for details, see IGEL OS Editions

  • The IGEL Managed Hypervisor Add-On License is deployed to the image creation machine and all target machines

Supported Operating Systems on Virtual Machines

The following operating systems can be used on virtual machines created and managed by the IGEL Managed Hypervisor:

  • Microsoft Windows XP

  • Microsoft Windows 7

  • Microsoft Windows Embedded Systems (WES) 7

  • Microsoft Windows 10

  • Microsoft Windows 10 IoT Core

  • Microsoft Windows 11

  • Microsoft Windows 11 IoT Core

Preparing the Image Creation Machine

Creating a profile for the IGEL Managed Hypervisor App

  1. Open the UMS Web Console, go to Profiles, and create a new profile.

image-20250714-113054.png

  1. Provide a Name for the profile and click Select Apps.

image-20250714-114127.png

  1. Select the app IGEL Managed Hypervisor and click Next.

image-20250714-114316.png

  1. If you want to configure the start options for the IMH Exporter, go to Apps > IGEL Managed Hypervisor > IMH Exporter and add/remove starting methods. In our example, we add a starter to the start menu and to the desktop.

image-20250723-102832.png

  1. If you want to configure the start options for virt-manager, the actual tool for creating the virtual machine, go to Apps > IGEL Managed Hypervisor > Virt-Manager and add/remove starting methods. In our example, we add a starter to the start menu and to the desktop.

image-20250723-120628.png

  1. Click Save and Close to finish the profile.

image-20250723-120702.png

  1. Go to Devices, select your image creation machine, and click Assign Object.

image-20250715-113235.png

  1. Find and select your profile and assign it to your device.

image-20250715-061000.png
image-20250715-061406.png

Providing the ISO File

We must ensure that the ISO file from which we will create the Golden Image is available to the image creation machine.

You can use the following methods to provide the ISO file:

  • Local installation media (ISO image on a USB memory stick, network drive, or CD-ROM)

  • Network installation

  • Manual installation

In our example, we will use a local installation medium.

→ Ensure that the installation media is accessible for IGEL OS.

Creating Your Golden Image on the Image Creation Machine

  1.  Click the virt-manager start icon. (In our example, we configured a start icon on the desktop.)

image-20250723-121351.png

The Virtual Machine Manager appears.

image-20250321-133403.png

  1. Click image-20250321-134107.png to create a new machine.

image-20250321-134159.png

  1. Select the source for the new virtual machine (in our example: Local install media (ISO image or CDROM)) and click Forward.

image-20250321-135221.png

  1. Select your installation media. Browse…

image-20250714-122044.png
image-20250714-122130.png

  1. Click Forward.

image-20250714-122222.png

  1. Choose the RAM size and the number of CPUs. Afterward, click Forward.

image-20250321-141657.png

  1. Review the size of the disk image that is to be created and click Forward.

We do NOT recommend selecting or creating custom storage; this might interfere with the preconfigured storage provided by IGEL Managed Hypervisor.

image-20250714-125432.png

  1. Select the network to be used by the virtual machine.

image-20250729-095817.png

  1. Review the settings and click Finish.

image-20250714-130040.png

The installer provided by the ISO file starts (in our example: Microsoft Windows XP).

image-20250714-130258.png

  1. Follow the instructions to install your guest system; if required, modify it according to your needs.

Exporting Your VM Image to the WebDAV server

  1. On the image creation machine, shut down the virtual machine.

  1. Start the IMH Exporter by clicking on this icon:

image-20250714-134020.png

  1. Enter the required data:

    • Server base URL: The path to the directory on the WebDAV repository

    • Username: The username for write access to the WebDAV repository

    • Password: The password associated with the username. Please note that the password must not contain “@”.

    • VM: Select the name of the image you have created.

image-20250730-085807.png

The following files are uploaded to the WebDAV repository:

  • <Server base URL>/<domain>.xml: An XML file that provides the size, URL, checksum, and compression method of the image file. Example: https://123.123.123.123/IGEL_IMH/winxp.xml

  • <Server base URL>/<domain>_d0.img.lz4: The image file, compressed with lz4. Example: https://123.123.123.123/IGEL_IMH/winxp_d0.img.lz4

Distributing Your VM Image to the Target Machines

  1. In the UMS Web Console, go to Profiles, and create a new profile.

image-20250714-113054.png

  1. Provide a Name for the profile and click Select Apps.

image-20250714-143345.png

  1. Select the app IGEL Managed Hypervisor and click Next.

image-20250714-114316.png

  1. Go to Apps > IGEL Managed Hypervisor > IGEL Hypervisor domains and click + to add a new domain.

image-20250714-143937.png

  1. Edit the data according to your needs:

  • VM name: The name of the virtual machine you have created

  • VM config source URL: The URL of the XML file you have exported

  • User name for remote server: The username for read access to the WebDAV repository

  • Password for remote server: The password associated with the username

  • Maximum memory usage: The maximum memory (RAM) used by the virtual machine

  • Number of vCPUs: The number of virtual CPUs

  • Autostart: When enabled, the virtual machine will be started automatically

  • Disk Image is immutable: If enabled, changes in the virtual machine will be gone when it is restarted. If this is disabled (default), changes in the virtual machine will persist after a restart.

  • MAC address for virtual interface: You can specify the MAC address of your virtual machine’s network interface. This is useful if the software in your virtual machine is licensed for a specific MAC address.

  • Type of network for this VM: The following networks are supported on the target machines:

    • isolated: The network interface is deactivated in the virtual machine.

    • NAT: Network Address Translation (NAT) is used; the host machine translates the internal IP address of the virtual machine to its own IP address.

    • bridged: The network device specified in Network device used for this VM. Will be ignored for some pre-configured bridge devices is used.

    • hostonly: The preconfigured hostonly bridge is used.

    • macvtap: The network device specified in Network device used for this VM. Will be ignored for some pre-configured bridge devices is used with the macvtap driver.

  • Network device used for this VM. Will be ignored for some pre-configured bridge devices: Create a network interface by setting the Registry key network.interfaces.ethernet.device<NUMBER>.bridge (System tab > Registry > network > interfaces > ethernet > device<NUMBER>.bridge to own). Example: If the setting has been made for device0, the network interface will be breth0. Enter the resulting name in this field.

image-20250730-103010.png

  1. Go to Apps > IGEL Managed Hypervisor > IGEL Hypervisor viewer sessions and click + to add a new session.

image-20250730-103627.png

  1. Enter a Session name and configure the start options according to your needs. For details on the start options, see Starting Methods for Apps .

image-20250730-104007.png

  1. Go to Apps > IGEL Managed Hypervisor > IGEL Hypervisor viewer sessions > [session name] > Virt-viewer Settings and edit the data according to your needs:

  • Name of the VM to connect to: The name of the virtual machine you have created

  • Icon large: By default, a generic icon will be used as the start icon. You can add the path to a custom icon

  • Kiosk Mode: If enabled, the user views the virtual machine in full-screen mode with limited controls, allowing interaction only with the VM itself. The viewer automatically connects to the specified virtual machine on startup..

image-20250730-105007.png

  1. Go to Devices, select your target machine, and click Assign Object.

image-20250715-061953.png

  1. Find and select your profile and assign it to your device.

image-20250715-062238.png
image-20250715-062436.png

When the profile is applied, the device downloads and installs the IGEL Managed Hypervisor app. Afterward, it downloads the virtual machine from the WebDAV repository. You can now access, start, and stop the virtual machine via the start icon.

Managing the Virtual Machine via the Universal Management Suite (UMS)

When the target device has received the virtual machine and restarted, a new tab labeled Managed Hypervisor is added.

image-20250715-104622.png

→ Click the refresh button to determine the current status of your virtual machines.

image-20250715-105240.png

The available possibilities of managing virtual machines on endpoint devices are described below.

Starting a Virtual Machine

→ To start a virtual machine, click image-20250729-105345.png.

image-20250729-105204.png

Stopping a Virtual Machine

→ To stop a virtual machine, click image-20250729-105615.png .

image-20250729-105238.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.