Jump to: navigation, search

StarlingX/Installation Guide

< StarlingX
Revision as of 18:09, 20 June 2018 by Abraham.arce.moreno (talk | contribs) (StarlingX Installation Guide)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU.

Software Configurations

  • All In One
  • Standard Controller Storage
  • Duplex
  • Standard Dedicated Storage

Standard Controller Storage


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 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 codenamed as tic_vb
  • StarlingX ISO Image

Deployment Environment Setup

This section describes how to set up a StarlingX 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

Installing Requirements and Dependencies

Install the required packages in an Ubuntu host system with:

$ sudo apt-get install git virt-manager libvirt-bin qemu-system

Installing Deployment Tool

Clone the <stx-deployment> project codenamed as tic_vb. Usually you’ll want to clone it under your user’s home directory.

$ cd $HOME
$ git clone https://github.intel.com/madawaska/tic_vb.git

Getting the StarlingX ISO Image

1. Get the StarlingX ISO Image from:


2. Copy the StarlingX ISO Image to the <stx-deployment> libvirt project directory naming it as bootimage.iso:

$ cp <starlingx iso image> $HOME/tic_vb/libvirt/bootimage.iso

Controller-0 Host Installation

Installing controller-0 involves initializing a host with software and then applying a configuration from the command line. The configured host becomes Controller-0.

  1. Using an ISO image of StarlingX, initialize the controller host via Libvirt/QEMU.
  2. Configure the controller using the config_controller script.

Initializing Controller-0

This section describes how to initialize StarlingX in host Controller-0. Except where noted, all the commands must be executed from a console of the Workstation.

  1. Navigate to the <stx-deployment> libvirt project directory:
    $ cd <stx-deployment>/libvirt
  2. Run the install packages script:
    $ bash install_packages.sh
  • Run the libvirt qemu setup script:
$ bash setup_tic.sh
  • From the KVM/VirtManager window, power on the host to be configured as Controller-0 and show the virtual machine console and details.
  • When the installer is loaded and the installer welcome screen appears in the Controller-0 host, select the type of installation "Standard Controller Configuration".
  • Select the "Graphical Console" as the console to use during installation.
  • Select "Standard Security Boot Profile" as the Security Profile.
  • Monitor the initialization until it is complete. When initialization is complete, a reboot is initiated on the Controller-0 host.
  • After a few minutes, the Controller-0 host reboots, briefly displays a GNU GRUB screen, and then boots automatically into the StarlingX image.
  • Log into Controller-0 as user wrsroot, with password wrsroot. The first time you log in as wrsroot, you are required to change your password. Enter the current password (wrsroot):
Changing password for wrsroot.
(current) UNIX Password:

Enter a new password for the wrsroot account:

New password:

Enter the new password again to confirm it:

Retype new password:

Controller-0 is initialized with StarlingX, and is ready for configuration.

Configuring Controller-0

This section describes how to perform the Controller-0 configuration interactively. Except where noted, all the commands must be executed from the console of the active controller (here assumed to be controller-0).

When run interactively, the config_controller script presents a series of prompts for initial configuration of StarlingX. The script is used to configure the first controller in the StarlingX cluster as controller-0. The prompts are grouped by configuration area. To start the script interactively, use the following command with no parameters and accept all the default values:

$ sudo config_controller

The output when config_controller script is run interactively is:

WARNING: Command should only be run from the console. Continuing with this
terminal may cause loss of connectivity and configuration failure
Apply the above configuration? [y/n]: y

Applying configuration (this will take several minutes):

01/08: Creating bootstrap configuration ... DONE
02/08: Applying bootstrap manifest ... DONE
03/08: Persisting local configuration ... DONE
04/08: Populating initial system inventory ... DONE
05:08: Creating system configuration ... DONE
06:08: Applying controller manifest ... DONE
07:08: Finalize controller configuration ... DONE
08:08: Waiting for service activation ... DONE

Configuration was applied

Please complete any out of service comissioning steps with system commands and unlock controller to proceed.