Difference between revisions of "StarlingX/Installation Guide"
(→Deployment Options) |
(→Intro) |
||
Line 2: | Line 2: | ||
This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU. | 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== | ==Deployment Options== |
Revision as of 23:14, 9 August 2018
Contents
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
- All-in-one