doc: Update Configurator

- Add Configurator Debian package build steps that were removed from GSG
- Add description of error icon on parameters tabs
- Mention that working folder name should be meaningful

Signed-off-by: Reyes, Amy <amy.reyes@intel.com>
This commit is contained in:
Reyes, Amy 2022-06-16 16:12:44 -07:00 committed by David Kinder
parent 6c35bb535d
commit 1accaaf2bb
2 changed files with 123 additions and 9 deletions

View File

@ -18,6 +18,8 @@ Capabilities:
XML format XML format
* Generates a launch script for each post-launched User VM * Generates a launch script for each post-launched User VM
.. _acrn_configurator_tool_prerequisites:
Prerequisites Prerequisites
************* *************
@ -29,6 +31,10 @@ Guide sections:
* :ref:`gsg-board-setup` * :ref:`gsg-board-setup`
* :ref:`gsg-dev-setup` * :ref:`gsg-dev-setup`
The above Getting Started Guide steps use a prebuilt Debian package to install
the ACRN Configurator. :ref:`acrn_configurator_tool_source` describes how to
build the Debian package.
Start with a New or Existing Configuration Start with a New or Existing Configuration
****************************************** ******************************************
@ -73,7 +79,8 @@ such as a board configuration file, scenario configuration file, and launch
scripts. If it finds any, it will delete them. scripts. If it finds any, it will delete them.
1. Under **Start a new configuration**, use the displayed working folder or 1. Under **Start a new configuration**, use the displayed working folder or
select a different folder by clicking **Browse for folder**. select a different folder by clicking **Browse for folder**. Use a
folder name that is meaningful to you.
.. image:: images/configurator-newconfig.png .. image:: images/configurator-newconfig.png
:align: center :align: center
@ -328,7 +335,10 @@ Save and Check for Errors
:align: center :align: center
:class: drop-shadow :class: drop-shadow
The tool saves your configuration data in a set of files in the working folder: The tool validates hypervisor and VM settings whenever you save.
If no errors occur, the tool saves your configuration data in a set of files
in the working folder:
* Scenario configuration file (``scenario.xml``): Raw format of all * Scenario configuration file (``scenario.xml``): Raw format of all
hypervisor and VM settings. You will need this file to build ACRN. hypervisor and VM settings. You will need this file to build ACRN.
@ -341,19 +351,123 @@ Save and Check for Errors
# Launch script for VM name: <name> # Launch script for VM name: <name>
The tool validates hypervisor and VM settings whenever you save. If an error If an error occurs, such as an empty required field, the tool saves the
occurs, such as an empty required field, the tool saves the changes to the changes to the scenario configuration file, but prompts you to correct the
files, but prompts you to correct the error. Error messages appear below the error.
applicable settings. Example:
.. image:: images/configurator-rederror.png #. On the selector menu, check for error messages on all tabs that have an error
icon. The following figure shows that the Hypervisor tab and the VM1 tab
contain errors.
.. image:: images/configurator-erroricon.png
:align: center :align: center
:class: drop-shadow :class: drop-shadow
#. Fix the errors and save again to generate a valid configuration. Error messages appear below the selector menu or below the applicable
parameter.
#. Fix all errors and save again to generate a valid configuration.
Next Steps Next Steps
========== ==========
After generating a valid scenario configuration file, you can build ACRN. See After generating a valid scenario configuration file, you can build ACRN. See
:ref:`gsg_build`. :ref:`gsg_build`.
.. _acrn_configurator_tool_source:
Build ACRN Configurator From Source Code
*****************************************
The :ref:`prerequisites<acrn_configurator_tool_prerequisites>` use a prebuilt
Debian package to install the ACRN Configurator. The following steps describe
how to build the Debian package from source code.
#. On the development computer, complete the steps in :ref:`gsg-dev-computer`.
#. Install the ACRN Configurator build tools:
.. code-block:: bash
sudo apt install -y libwebkit2gtk-4.0-dev \
build-essential \
curl \
wget \
libssl-dev \
libgtk-3-dev \
libappindicator3-dev \
librsvg2-dev \
python3-venv
#. Install Node.js (npm included) as follows:
a. We recommend using nvm to manage your Node.js runtime. It allows you to
switch versions and update Node.js easily.
.. code-block:: bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash
#. Rerun your ``.bashrc`` initialization script and then install the latest
version of Node.js and npm:
.. code-block:: bash
source ~/.bashrc
nvm install node --latest-npm
nvm use node
#. Install and upgrade Yarn:
.. code-block:: bash
npm install --global yarn
#. Install rustup, the official installer for Rust:
.. code-block:: bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
When prompted by the Rust installation script, type ``1`` and press
:kbd:`Enter`.
.. code-block:: console
1) Proceed with installation (default)
2) Customize installation
3) Cancel installation
>1
#. Configure the current shell:
.. code-block:: bash
source $HOME/.cargo/env
#. Install additional ACRN Configurator dependencies:
.. code-block:: bash
cd ~/acrn-work/acrn-hypervisor/misc/config_tools/configurator
python3 -m pip install -r requirements.txt
yarn
#. Build the ACRN Configurator Debian package:
.. code-block:: bash
cd ~/acrn-work/acrn-hypervisor
make configurator
#. Install the ACRN Configurator:
.. code-block:: bash
sudo apt install -y ~/acrn-work/acrn-hypervisor/build/acrn-configurator_*_amd64.deb
#. Launch the ACRN Configurator:
.. code-block:: bash
acrn-configurator

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB