StarlingX/Installation Guide

Intro

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

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 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:

Tbd

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.
Procedure:

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.