StarlingX/Installation Guide
Contents
Intro
This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU.
Requirements
Different use cases require different configurations. For general StarlingX deployment, the recommended minimum requirements include:
Hardware Requirements
A workstation computer with:
- Processor: x86_64 only supported architecture with BIOS enabled hardware virtualization extensions
- Memory: At least 32GB RAM
- Hard Disk: 500GB HDD
- Network: Two network adapters with active Internet connection
Software Requirements
A workstation computer with:
- Operating System: Freshly installed Ubuntu 16.04 LTS 64-bit
- Proxy settings configured (if applies)
- Git
- KVM/VirtManager
- Libvirt Library
- QEMU Full System Emulation Binaries
- <stx-deployment> project
- StarlingX ISO Image
Deployment Environment Setup
This section describes how to set up a StarlingX Controller Storage system in a workstation computer. After completing these steps, you will be able to deploy and run your StarlingX system on the following Linux distribution:
- Ubuntu 16.04 LTS 64-bit
Updating Your Operating System
Before proceeding with the build, ensure your OS is up to date. You’ll first need to update the local database list of available packages:
$ sudo apt-get update
Install stx-tools project
Clone the stx-tools project. Usually you’ll want to clone it under your user’s home directory.
$ cd $HOME $ git clone git://git.openstack.org/openstack/stx-tools
Temporal! Check if the following Gerrit Reviews are merged, if not, cherry pick them.
https://review.openstack.org/#/c/585588/
Installing Requirements and Dependencies
Navigate to the stx-tools installation libvirt directory:
$ cd $HOME/stx-tools/deployment/libvirt/
Install the required packages:
$ bash install_packages.sh
Getting the StarlingX ISO Image
Follow the instructions from StarlingX/Developer_Guide to build a StarlingX ISO image. Copy the StarlingX ISO Image to the <stx-deployment> libvirt project directory naming it as bootimage.iso:
$ cp <starlingx iso image> $HOME/stx-tools/deployment/libvirt/bootimage.iso
Disabling Firewall
Unload firewall and disable firewall on boot:
$ sudo ufw disable Firewall stopped and disabled on system startup $ sudo ufw status Status: inactive
Deployment Options
- Standard Controller
- All-in-one