Files
acrn-hypervisor/misc/config_tools/configurator
Yonghua Huang a7a6732580 config_tools: support IVSHMEM devices region ID configuration
This patch adds ivshmem region ID configuration support when user
   configure ACRN IVSHMEM devices via ACRN config tool, this ID provides
   VMs with a stable identification of multiple shared memory regions.

   Also add logic to generate launch script with region ID configured
   as below:
   `add_virtual_device  8 ivshmem hv:/shm_region_0,256,1`

Tracked-On: #8566
Signed-off-by: Kunhui-Li <kunhuix.li@intel.com>
Signed-off-by: Yonghua Huang <yonghua.huang@intel.com>
Reviewed-by: Junjie Mao <junjie.mao@intel.com>
2024-03-28 14:34:38 +08:00
..

ACRN Configurator

This version is based on Tauri, WIP.

Features

Support Platforms

  • Linux (.deb, AppImage)
  • Windows 7,8,10 (.exe, .msi)

Setting Up

1. Install System Dependencies

  1. Please follow this guide to install system dependencies.
  2. Download and install Nodejs.
  3. Please follow this guide to install yarn.

Linux

In Linux, make sure your already install git, python3(version>=3.6) and python3-venv library,

$ sudo apt install git python3 python3-venv
# check python3 version
$ python3 --version
Python 3.8.10

Windows

Chocolatey is a package manager tool for windows, you can use choco install xsltproc to install xsltproc package, which provide xmllint command.

Make sure your system have python which version>3.6, you can check it by following command line:

$ python --version
Python 3.8.10

If your system doesn't have git and python, you can install it by choco install git python3.

2. Clone Project And Install Project Dependencies.

Linux

git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor/misc/config_tools/configurator
python3 -m pip install -r requirements.txt
yarn

Windows

Similar to Linux, in the Windows environment, you need replace the command line python3 with python.

3. How To Build

Linux

Run this command in the acrn-hypervisor directory.

make configurator

Windows

Run following command in the 'acrn-hypervisor' directory.

cd misc\config_tools
python scenario_config\schema_slicer.py
python scenario_config\jsonschema\converter.py
xmllint --xinclude schema\datachecks.xsd > schema\allchecks.xsd

python -m build
del configurator\packages\configurator\thirdLib\acrn_config_tools-3.0-py3-none-any.whl

cd configurator
python packages\configurator\thirdLib\manager.py install
yarn
yarn build

4. How To Run

Linux

Run this command in the acrn-hypervisor directory.

sudo apt install ./build/acrn-configurator_*.deb
acrn-configurator

Windows

You can find installer under the misc\config_tools\configurator\packages\configurator\src-tauri\target\release\bundle\msi directory, the installer in the folder.