docs/doc/source/shared/_includes/automated_setup.txt
Ron Stone 287cd4dc39 Merge Virtual and Bare Metal install docs
Incorporate Virtual content in BM AIO-DX install proc using synchronized tabs.
Make self-referential include paths relative
Move virtual includes to conventional folder for shared content
Convert link to root of Install docs to external. This is required
because link source page is used in context where internal ref is
not available
Address review comments from patchset 5
Integrate change on AIO-SX
Integrate Std with Storage
Integrate Dedicated Storage
Share includes to avoid indentation formatting errors (greybars) in DS
builds

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Ie04c5f8a065b5e2bf87176515bb1131b75a4fcf3
2024-01-12 17:21:02 +00:00

81 lines
1.9 KiB
Plaintext

The following sections describe the system requirements and host setup for a
workstation hosting virtual machine(s) where StarlingX will be deployed.
*********************
Hardware requirements
*********************
The host system should have at least:
* **Processor:** x86_64 only supported architecture with BIOS enabled hardware
virtualization extensions
* **Cores:** 8
* **Memory:** 32GB RAM
* **Hard Disk:** 500GB HDD
* **Network:** One network adapter with active Internet connection
*********************
Software requirements
*********************
The host system should have at least:
* A workstation computer with Ubuntu 20.04 LTS 64-bit
**********
Host setup
**********
Set up the host with the following steps:
#. Update OS and install dependencies:
.. code-block:: none
apt-get update
sudo apt install -y virtualbox socat git rsync sshpass openssh-client python3-pip python3-venv
#. Clone the StarlingX tools repository:
.. code-block:: none
cd $HOME
git clone https://opendev.org/starlingx/virtual-deployment.git
#. Set up Python's Virtual Environment:
.. code-block:: none
cd $HOME/virtual-deployment/virtualbox/pybox
python3 -m venv venv
source ./venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
#. Create NatNetwork:
.. code-block:: none
VBoxManage natnetwork add --netname NatNetwork --network 10.10.10.0/24 --dhcp off --ipv6 on
#. Get the StarlingX ISO:
.. code-block:: none
wget https://mirror.starlingx.windriver.com/mirror/starlingx/release/8.0.0/debian/monolithic/outputs/iso/starlingx-intel-x86-64-cd.iso -O $HOME/Downloads/stx-8.iso
#. Create a local copy of the config file templates.
.. code-block:: none
cp -r config myconfig
Make the desired changes in the config files on the new directory.
.. note::
This setup guide can be found in the README.md file in $HOME/virtual-deployment/virtualbox/pybox