Difference between revisions of "StarlingX/Installation Guide"
m (Abraham.arce.moreno moved page StarlingX/Installation Guide to StarlingX/Installation Guide Virtual Environment) |
(→Requirements) |
||
Line 5: | Line 5: | ||
==Requirements== | ==Requirements== | ||
− | Different use cases require different configurations. For | + | Different use cases require different configurations. For the StarlingX Deployment Options described later, the recommended minimum requirements for the workstation, running the Virtual Machine(s) where StarlingX will be deployed, include: |
===Hardware Requirements=== | ===Hardware Requirements=== |
Revision as of 16:40, 21 August 2018
Contents
Intro
This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU. This environment should only be used for evaluation or development purposes; real deployments of StarlingX are only supported on physical servers.
Requirements
Different use cases require different configurations. For the StarlingX Deployment Options described later, 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
- 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 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