Difference between revisions of "StarlingX/Installation Guide"

Revision as of 23:14, 9 August 2018

Intro

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

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
- StarlingX Cloud with Dedicated Storage
- StarlingX Cloud with Controller Storage
All-in-one
- StarlingX Cloud Duplex
- StarlingX Cloud Simplex

@@ Line 2: / Line 2: @@
 This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU.
+==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:
+<pre><nowiki>
+$ sudo apt-get update
+</nowiki></pre>
+===Install stx-tools project===
+Clone the stx-tools project. Usually you’ll want to clone it under your user’s home directory.
+<pre><nowiki>
+$ cd $HOME
+$ git clone git://git.openstack.org/openstack/stx-tools
+</nowiki></pre>
+<strong> Temporal! </strong> Check if the following Gerrit Reviews are merged, if not, cherry pick them. <br>
+https://review.openstack.org/#/c/585588/ <br>
+===Installing Requirements and Dependencies===
+Navigate to the stx-tools installation libvirt directory:
+<pre><nowiki>
+$ cd $HOME/stx-tools/deployment/libvirt/
+</nowiki></pre>
+Install the required packages:
+<pre><nowiki>
+$ bash install_packages.sh
+</nowiki></pre>
+===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:
+<pre><nowiki>
+$ cp <starlingx iso image> $HOME/stx-tools/deployment/libvirt/bootimage.iso
+</nowiki></pre>
+===Disabling Firewall===
+Unload firewall and disable firewall on boot:
+<pre><nowiki>
+$ sudo ufw disable
+Firewall stopped and disabled on system startup
+$ sudo ufw status
+Status: inactive
+</nowiki></pre>
 ==Deployment Options==