Difference between revisions of "StarlingX/Installation Guide"
(StarlingX Installation Guide) |
(No difference)
|
Revision as of 18:09, 20 June 2018
Contents
Intro
This section contains information about the StarlingX installation in a virtualized environment using Libvirt/QEMU.
Software Configurations
- All In One
- Standard Controller Storage
- Duplex
- Standard Dedicated Storage
Standard Controller Storage
Requirements
Different use cases require different configurations. For general StarlingX deployment, the recommended minimum requirements include:
Hardware Requirements
A workstation computer with:
- Processor: x86_64 only supported architecture with 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 codenamed as tic_vb
- 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
Installing Requirements and Dependencies
Install the required packages in an Ubuntu host system with:
$ sudo apt-get install git virt-manager libvirt-bin qemu-system
Installing Deployment Tool
Clone the <stx-deployment> project codenamed as tic_vb. Usually you’ll want to clone it under your user’s home directory.
$ cd $HOME $ git clone https://github.intel.com/madawaska/tic_vb.git
Getting the StarlingX ISO Image
1. Get the StarlingX ISO Image from:
Tbd
2. Copy the StarlingX ISO Image to the <stx-deployment> libvirt project directory naming it as bootimage.iso:
$ cp <starlingx iso image> $HOME/tic_vb/libvirt/bootimage.iso
Controller-0 Host Installation
Installing controller-0 involves initializing a host with software and then applying a configuration from the command line. The configured host becomes Controller-0.
Procedure:
- Using an ISO image of StarlingX, initialize the controller host via Libvirt/QEMU.
- Configure the controller using the config_controller script.
Initializing Controller-0
This section describes how to initialize StarlingX in host Controller-0. Except where noted, all the commands must be executed from a console of the Workstation.
- Navigate to the <stx-deployment> libvirt project directory:
- $ cd <stx-deployment>/libvirt
- Run the install packages script:
- $ bash install_packages.sh
- Run the libvirt qemu setup script:
$ bash setup_tic.sh
- From the KVM/VirtManager window, power on the host to be configured as Controller-0 and show the virtual machine console and details.
- When the installer is loaded and the installer welcome screen appears in the Controller-0 host, select the type of installation "Standard Controller Configuration".
- Select the "Graphical Console" as the console to use during installation.
- Select "Standard Security Boot Profile" as the Security Profile.
- Monitor the initialization until it is complete. When initialization is complete, a reboot is initiated on the Controller-0 host.
- After a few minutes, the Controller-0 host reboots, briefly displays a GNU GRUB screen, and then boots automatically into the StarlingX image.
- Log into Controller-0 as user wrsroot, with password wrsroot. The first time you log in as wrsroot, you are required to change your password. Enter the current password (wrsroot):
Changing password for wrsroot. (current) UNIX Password:
Enter a new password for the wrsroot account:
New password:
Enter the new password again to confirm it:
Retype new password:
Controller-0 is initialized with StarlingX, and is ready for configuration.
Configuring Controller-0
This section describes how to perform the Controller-0 configuration interactively. Except where noted, all the commands must be executed from the console of the active controller (here assumed to be controller-0).
When run interactively, the config_controller script presents a series of prompts for initial configuration of StarlingX. The script is used to configure the first controller in the StarlingX cluster as controller-0. The prompts are grouped by configuration area. To start the script interactively, use the following command with no parameters and accept all the default values:
$ sudo config_controller
The output when config_controller script is run interactively is:
WARNING: Command should only be run from the console. Continuing with this terminal may cause loss of connectivity and configuration failure ... Apply the above configuration? [y/n]: y Applying configuration (this will take several minutes): 01/08: Creating bootstrap configuration ... DONE 02/08: Applying bootstrap manifest ... DONE 03/08: Persisting local configuration ... DONE 04/08: Populating initial system inventory ... DONE 05:08: Creating system configuration ... DONE 06:08: Applying controller manifest ... DONE 07:08: Finalize controller configuration ... DONE 08:08: Waiting for service activation ... DONE Configuration was applied Please complete any out of service comissioning steps with system commands and unlock controller to proceed.