Jump to: navigation, search

StarlingX/Installation Guide

< StarlingX
Revision as of 20:50, 4 October 2018 by Abraham.arce.moreno (talk | contribs) (Bare Metal)

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:

Requirements

Different use cases require different configurations.

Bare Metal

The general requirements for the physical servers where StarlingX might be deployed, include:

  • Controller Hosts
    • Primary Hard Drive, minimum 500 GB for OS and system databases.
    • Secondary Hard Drive, minimum 500 GB for persistent VM storage.
    • Minimum Processor, Dual-CPU Intel® Xeon®
    • Minimum Memory: 64 GB
    • Two physical Ethernet interfaces
    • USB boot support
    • PXE boot support
  • Storage Hosts
    • Primary Hard Drive, minimum 500 GB for OS and system databases.
    • Secondary Hard Drive, minimum 500 GB for persistent VM storage.
    • Minimum Processor, Dual-CPU Intel® Xeon®
    • Minimum Memory: 64 GB
    • Three physical Ethernet interfaces
    • PXE boot support
  • Compute Hosts
    • Primary Hard Drive, minimum 500 GB for OS and system databases.
    • Secondary Hard Drive, minimum 500 GB for persistent VM storage.
    • Minimum Processor, Dual-CPU Intel® Xeon®
    • Minimum Memory: 32 GB
    • Three physical Ethernet interfaces
    • PXE boot support


The recommended minimum requirements for the physical servers are described later in each StarlingX Deployment Options guide.

Virtual Environment

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 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
Disabling Firewall

Unload firewall and disable firewall on boot:

$ sudo ufw disable
Firewall stopped and disabled on system startup
$ sudo ufw status
Status: inactive

Getting the StarlingX ISO Image

Follow the instructions from StarlingX/Developer_Guide to build a StarlingX ISO image.

Bare Metal

A bootable USB flash drive containing StarlingX ISO image.

Virtual Environment

Copy the StarlingX ISO Image to the <stx-deployment> libvirt project directory:

$ cp <starlingx iso image> $HOME/stx-tools/deployment/libvirt/

Deployment Options