Hypervisor on Module (AN56): Difference between revisions

From conga-wiki
No edit summary
Line 104: Line 104:
::[[File:Hypervisor on Module (006).png|none|thumb|450x450px]]
::[[File:Hypervisor on Module (006).png|none|thumb|450x450px]]
The installation is complete, when the command line output shows "Script finished successfully".
The installation is complete, when the command line output shows "Script finished successfully".
==Select Boot Priority==
To activate the RTS Hypervisor, you need to change the "1st Boot Device" in the BIOS setup menu to "Integrated RTS Hypervisor".
{{Continue Numbered List|1|Press F2 or DEL during POST to enter the BIOS setup menu.}}
{{Continue Numbered List|2|Go to the Boot tab to enter the Boot setup screen.}}
{{Continue Numbered List|3|Select "Integrated RTS Hypervisor" as "1st Boot Device".}}
{{Continue Numbered List|4|Go to the Save & Exit tab and select "Save Changes and Exit".}}
The system restarts.
::[[File:Hypervisor on Module (007).png|none|thumb|450x450px]]
{{Note|The configuration steps and the BIOS setup menu above are valid for "Type Based Boot Priority".}}
===Boot Messages and First Steps===
Sample screen shot of the RTS-Hypervisor boot messages.
::[[File:Hypervisor on Module (008).png|none|thumb|450x450px]]
When the system starts or restarts, the General-Purpose Operating System controls are screen while the Real-Time Operating System runs silently in the background.
::[[File:Hypervisor on Module (009).png|none|thumb|450x450px]]
The pre-built congatec demo images for Linux, VxWorks and QNX real-time systems contain a telnet server. Connection to the telnet server is possible with the default. IP address (192.168.2.2) of the virtual network in the Real-Time Operating System. For information about user credentials, see the RTS-Hypervisor.pdf manual included in the download package. The INtime D-RTOS demo image does not contain a telnet server. It uses a webserver. To access the webserver, open a web browser on your General-Purpose Operating System and go to <nowiki>http://192.168.2.2</nowiki>. For more details, see the RTS-Hypervisor.pdf manual included in the download package.
===Override the Default Boot Selection Manually===
You can override the hypervisor as the default boot selection if the RTS Hypervisor has configuration issues. To override the hypervisor:
{{Continue Numbered List|1|Turn on the system.}}
{{Continue Numbered List|2|Press F11 to enter the Boot menu.}}
{{Continue Numbered List|3|Select the General-Purpose Operating System from the Boot Menu. For example, the Windows EFI Boot Manager in the image below.}}

Revision as of 12:33, 13 August 2024

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.
#cd /home/rts/Downloads
#unzip RTH-Release_R5.7.03.31450_VxWorks_runtime.zip
Hypervisor on Module (004).png
  2. Navigate to the directory of the extracted package. For example:
#cd RTH-Release_RS.7.03.31450_VxWorks_runtime/
  2. Type "bash installation_for_linux.sh" to run the installation script (requires root privilege)
#bash installation_for_linux.sh
Hypervisor on Module (005).png

The installation process begins. The output of the command line interface is shown below:

Hypervisor on Module (006).png

The installation is complete, when the command line output shows "Script finished successfully".

Select Boot Priority

To activate the RTS Hypervisor, you need to change the "1st Boot Device" in the BIOS setup menu to "Integrated RTS Hypervisor".

  2. Press F2 or DEL during POST to enter the BIOS setup menu.
  4. Go to the Boot tab to enter the Boot setup screen.
  6. Select "Integrated RTS Hypervisor" as "1st Boot Device".
  8. Go to the Save & Exit tab and select "Save Changes and Exit".

The system restarts.

Hypervisor on Module (007).png


Note:

The configuration steps and the BIOS setup menu above are valid for "Type Based Boot Priority".

Boot Messages and First Steps

Sample screen shot of the RTS-Hypervisor boot messages.

Hypervisor on Module (008).png

When the system starts or restarts, the General-Purpose Operating System controls are screen while the Real-Time Operating System runs silently in the background.

Hypervisor on Module (009).png

The pre-built congatec demo images for Linux, VxWorks and QNX real-time systems contain a telnet server. Connection to the telnet server is possible with the default. IP address (192.168.2.2) of the virtual network in the Real-Time Operating System. For information about user credentials, see the RTS-Hypervisor.pdf manual included in the download package. The INtime D-RTOS demo image does not contain a telnet server. It uses a webserver. To access the webserver, open a web browser on your General-Purpose Operating System and go to http://192.168.2.2. For more details, see the RTS-Hypervisor.pdf manual included in the download package.

Override the Default Boot Selection Manually

You can override the hypervisor as the default boot selection if the RTS Hypervisor has configuration issues. To override the hypervisor:

  2. Turn on the system.
  2. Press F11 to enter the Boot menu.
  2. Select the General-Purpose Operating System from the Boot Menu. For example, the Windows EFI Boot Manager in the image below.
Retrieved from "https://wiki.congatec.com:443/index.php?title=Hypervisor_on_Module_(AN56)&oldid=794"