Jump to: navigation, search

StarlingX/Installation Guide

< StarlingX
Revision as of 19:06, 1 October 2018 by Abraham.arce.moreno (talk | contribs) (Intro)


StarlingX may be installed in:

  • Bare Metal: Real deployments of StarlingX are only supported on physical servers.
  • 'Virtual Environment: It should only be used for evaluation or development purposes.

StarlingX installed in virtual environments has two options currently known to work:


Different use cases require different configurations. For the StarlingX Deployment Options described later, the recommended minimum requirements for the workstation, running the Virtual Machine(s) where StarlingX will be deployed, include:

Hardware Requirements

A workstation computer with:

  • Processor: x86_64 only supported architecture with BIOS enabled hardware virtualization extensions
  • Cores: 8 (4 with careful monitoring of cpu load)
  • 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

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