13. Hypervisor Backend

The System Manager consists of several components based on the hypervisor backend. This is the interface to the Hypervisor. The backend interacts with the Hypervisor (running on the same Hypervisor Host), e.g. to add guests, adjust configuration files etc. The default installation of the hypervisor backend is in /hv/sysmgr.

The most common use of the hypervisor backend is through the system manager in the browser, which communicates with the hypervisor backend via the Web Application.

The hypervisor backend can also be used directly by calling the system manager core application.

13.1. System Manager Core Application

The System Manager Backend has a command line interface which supports helpful functions like loading an existing project file and apply the related configuration.

This may be useful for automated testing with different guest and configuration scenarios. Project files are stored in /hv/sysmgr/WorkingDir.

It is not possible to make multiple changes in one step. Multiple changes can be achieved step by step. To do this, the project is loaded with /loadConfig, the desired change is made (e.g. /CONFIGUREGUEST), and then saved with /saveConfig.

All available parameters of the HvCoreApp are shown with /help.

cd /hv/sysmgr
sudo ./HvCoreApp /help

13.1.1. Loading an existing configuration

cd /hv/sysmgr
sudo ./HvCoreApp /loadconfig='./WorkingDir/MyProject.hwc' /sync

This will apply an existing configuration stored in /hv/sysmgr/WorkingDir/MyProject.hwc.

Caution

Existing guest folders will be removed!

13.1.2. Saving a configuration

cd /hv/sysmgr
sudo ./HvCoreApp /saveconfig='./WorkingDir/MyProject.hwc'

This will save the configuration in /hv/sysmgr/WorkingDir/MyProject.hwc. If the project file doesn’t exist a new one will be created.

13.1.3. Assign CPU to guest

cd /hv/sysmgr
sudo ./HvCoreApp /CONFIGUREGUEST=GUEST0001:CpuMask:0x0001000

This will assign CPU 3 to GUEST0001

13.1.4. Adjust amount of CPUs assigned to guest

cd /hv/sysmgr
sudo ./HvCoreApp /CONFIGUREGUEST=GUEST0001:Cpu:2

This will assign 2 CPUs to GUEST0001

13.1.5. Adjust guest RAM size

cd /hv/sysmgr
sudo ./HvCoreApp /CONFIGUREGUEST=GUEST0001:Memory:256

This will assign 256MB RAM size to RTOS GUEST0001