mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-06-02 20:35:32 +00:00

History

Junjie Mao 7ce49f8c3c config_tools: determine SSRAM_ENABLED automatically Today users are able to tweak whether the hypervisor includes support to software SRAM (SSRAM). This, however, gives rise to potential functional incorrectness when the hypervisor is not built with such support but a service VM attempts to assign SSRAM to a post-launched VM (which is possible as the service VM can still see the SSRAM-related ACPI tables). In such cases the SSRAM assigned to a post-launched VM is not properly initialized and thus not locked in cache. As makes little sense for a user to configure the SSRAM support in the hypervisor in a different way as the presence of SSRAM on hardware, this patch removes the "SSRAM support" option from the configurator. The config tools will now automatically enable the SSRAM support if the hardware supports the feature and disable that otherwise. Tracked-On: #8231 Signed-off-by: Junjie Mao <junjie.mao@intel.com>		2022-10-14 15:20:48 +08:00
..
packages	config_tools: determine SSRAM_ENABLED automatically	2022-10-14 15:20:48 +08:00
pyodide	config_tools: support dynamic enum names in XML schema	2022-08-29 17:48:12 +08:00
__init__.py	config_tools: Add vue-json-schema-form and advanced custom component for IVSHMEM field	2022-05-08 15:52:28 +08:00
.gitignore	config_tools: refactor configurator for web page cache issue	2022-04-25 18:13:12 +08:00
package.json	config_tools: Add vue-json-schema-form and advanced custom component for IVSHMEM field	2022-05-08 15:52:28 +08:00
README.md	config-tools: fix typos of UI and README	2022-09-14 08:44:57 +08:00
requirements.txt	config-tools: modified requirements.txt and update GSG	2022-08-26 16:56:16 +08:00
tsconfig.json	config_tools: refactor configurator for web page cache issue	2022-04-25 18:13:12 +08:00
yarn.lock	config_tools: add custom CAT widget	2022-05-22 20:10:24 +08:00

README.md

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

Please follow this guide to install system dependencies.
Download and install Nodejs.
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.