Jump to: navigation, search

Difference between revisions of "StarlingX/Installation Guide"

(Deployment Options)
 
(36 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
 +
 +
See the [https://docs.starlingx.io/deploy_install_guides/index.html StarlingX Deploy and Installation Guide] for information on installing StarlingX.  This wiki page has been deprecated.
 +
 +
<!--
 +
 
== Intro ==
 
== Intro ==
  
This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU.
+
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.
 +
<br>
 +
StarlingX installed in virtual environments has two options:
 +
* [[Installation_libvirt_qemu|Libvirt/QEMU]]
 +
* VirtualBox
 +
 
 +
== Requirements ==
 +
 
 +
Different use cases require different configurations.
 +
 
 +
=== Bare Metal ===
 +
 
 +
The minimum requirements for the physical servers where StarlingX might be deployed, include:
 +
 
 +
* '''Controller Hosts'''
 +
** Minimum Processor is:
 +
*** Dual-CPU Intel® Xeon® E5 26xx Family (SandyBridge) 8 cores/socket
 +
** Minimum Memory: 64 GB
 +
** Hard Drives:
 +
*** Primary Hard Drive, minimum 500 GB for OS and system databases.
 +
*** Secondary Hard Drive, minimum 500 GB for persistent VM storage.
 +
** 2 physical Ethernet interfaces: OAM and MGMT Network.
 +
** USB boot support.
 +
** PXE boot support.
 +
* '''Storage Hosts'''
 +
** Minimum Processor is:
 +
*** Dual-CPU Intel® Xeon® E5 26xx Family (SandyBridge) 8 cores/socket.
 +
** Minimum Memory: 64 GB.
 +
** Hard Drives:
 +
*** Primary Hard Drive, minimum 500 GB for OS.
 +
*** 1 or more additional Hard Drives for CEPH OSD storage, and
 +
*** Optionally 1 or more SSD or NVMe Drives for CEPH Journals.
 +
** 1 physical Ethernet interface: MGMT Network
 +
** PXE boot support.
 +
* '''Compute Hosts'''
 +
** Minimum Processor is:
 +
*** Dual-CPU Intel® Xeon® E5 26xx Family (SandyBridge) 8 cores/socket.
 +
** Minimum Memory: 32 GB.
 +
** Hard Drives:
 +
*** Primary Hard Drive, minimum 500 GB for OS.
 +
*** 1 or more additional Hard Drives for ephemeral VM Storage.
 +
** 2 or more physical Ethernet interfaces: MGMT Network and 1 or more Provider Networks.
 +
** PXE boot support.
 +
<br>
 +
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, hosting 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:
  
==Deployment Options==
+
* 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 the workstation computer which will host the Virtual Machine(s) where StarlingX will be deployed.
 +
 
 +
===== 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>
 +
 
 +
===== 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>
 +
 
 +
===== 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>
 +
 
 +
== 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-tools deployment libvirt project directory:
 +
 
 +
<pre><nowiki>
 +
$ cp <starlingx iso image> $HOME/stx-tools/deployment/libvirt/
 +
</nowiki></pre>
 +
 
 +
== Deployment Options ==
  
 
* Standard Controller
 
* Standard Controller
Line 11: Line 150:
 
** [[StarlingX/Installation Guide/Duplex|StarlingX Cloud Duplex]]
 
** [[StarlingX/Installation Guide/Duplex|StarlingX Cloud Duplex]]
 
** [[StarlingX/Installation Guide/Simplex|StarlingX Cloud Simplex]]
 
** [[StarlingX/Installation Guide/Simplex|StarlingX Cloud Simplex]]
 +
 +
-->

Latest revision as of 20:53, 26 July 2019


See the StarlingX Deploy and Installation Guide for information on installing StarlingX. This wiki page has been deprecated.