Hypervisor on Module (AN56)

From conga-wiki
Affected Products All congatec products that support the RTS Hypervisor

Preface

This Application Note gives a general overview of how to install, configure, use and troubleshoot the RTS Hypervisor on congatec x86-based modules.

For more information about the RTS Hypervisor, refer to the RTS Hypervisor Manual “RTS-Hypervisor.pdf”.

Terminology

Term Description
ESP EFI System Partition
GPOS General-Purpose Operating System
OS Operating System
RTS Real Time Systems
RTOS Real-Time Operating System

Introduction

As part of the aReady.COM strategy, the RTS Hypervisor is now integrated into the congatec firmware by default on congatec x86-based modules. The integrated RTS Hypervisor offers a 30-day free evaluation license. The 30-day evaluation starts when the customer receives the x86-based modules.

The Real-Time Operating System images, driver packages for the General-Purpose Operating System and the installation procedures for the Operating Systems are available for download in the restricted area of congatec website at www.congatec.com/login.

The packages available for download are listed in the table below.

Package Name Description
RTH-Release_R5.7.03.31618_INtime_runtime.zip Prepared Evaluation Package for INtime DRTOS
RTH-Release_R5.7.03.31618_Linux-rt_runtime.zip Prepared Evaluation Package for Debian with prempt-rt
RTH-Release_R5.7.03.31618_Linux-xenomai_runtime.zip Prepared Evaluation Package for Debian with Xenomai
RTH-Release_R5.7.03.31618_QNX_runtime.zip Prepared Evaluation Package for BlackBerry QNX. Only provided with GPOS Windows
RTH-Release_R5.7.03.31618_VxWorks_runtime.zip Prepared Evaluation Package for WindRiver VxWorks

Installing the Packages

This section describes how to install and configure the packages for the integrated RTS Hypervisor.

Installation Requirements

Before you install the packages for the integrated RTS Hypervisor:

  2. Make sure a General-Purpose Operating System (GPOS) is pre-installed. The General-Purpose Operating System must be installed on a mass storage connected to an AHCI controller or an NVMe controller.
  4. The RTS Hypervisor supports different types and versions of GPOS. For the list of GPOS types and versions supported by the RTS Hypervisor, see n<owiki>https://www.real-time-systems.com/products/os-compatibility/</nowiki>.
  6. Assign at least 128 GB storage to the System Drive (C:) if you use Microsoft Windows OS as General-Purpose Operating System. The System Drive must have at least 4GB of free disk space.
  8. If you use a Linux OS as General-Purpose Operating System, the ESP partition must have at least 300 MB of free disk space. The root file system must have at least 1 GB of free disk space.

Download Installation Package

  2. Log in to the congatec customer portal at www.congatec.com/login
  4. In the "Technical Information" list, click "Virtualization Ready RTOS Packages". The package page opens.
  6. Download the appropriate packages for your GPOS.

Install the Downloaded Package

The downloaded package contains installation scripts for both Windows and Linux General-Purpose Operating Systems.

Run the installation_for_windows.bat script for systems pre-installed with Windows Operating System. The installation steps are described in section 2.2.1 “Windows Operating System”. For systems pre-installed with Linux Operating System, run the installation_for_linux.sh script. The installation steps are described in section 2.2.2 “Linux Operating System”.

Windows Operating System

  2. Unzip the downloaded package for your intended Real Time Operating System to a location on your system for the RTS Hypervisor. For example, C:\Users\rts\Desktop.
  4. Open the command prompt.
  6. Navigate to the directory of the extracted package. For example:
cd RTH-Release_R5.7.03.31450_Linux-rt_runtime
  2. Type installation_for_windows.bat and press Enter.
The User Account Control prompot appears
  2. Click Yes to confirm.
Hypervisor on Module (002).png
The installation process begins. The output of the command line is shown below:
The installation is complete, when the command line output shows "RTS Hypervisor Installation done".

Linux Operating System

  2. Open the command line interface.
  4. Unzip the downloaded package for your intended Real Time Operating System to a location on your system for the RTS Hypervisor. For example, /home/rts/Downloads.
  5. cd /home/rts/Downloads
  6. unzip RTH-Release_R5.7.03.31450_VxWorks_runtime.zip
  2. default
  4. default
Retrieved from "https://wiki.congatec.com:443/index.php?title=Hypervisor_on_Module_(AN56)&oldid=784"