Skip to content

Latest commit

 

History

History
105 lines (65 loc) · 2.93 KB

source-install-ubuntu.rst

File metadata and controls

105 lines (65 loc) · 2.93 KB
Raw

Source Install Ubuntu

This section describes how to install and configure the Skyline Console service. Before you begin, you must have a ready OpenStack environment. At least it includes keystone, glance, nova, neutron and skyline-apiserver service.

For more information about skyline-apiserver installation, refer to the OpenStack Skyline APIServer Guide.

Prerequisites

  1. Install system dependencies

    sudo apt update
sudo apt install -y git python3-pip nginx make ssl-cert
sudo apt-get install libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2 libxtst6 xauth xvfb

  2. Install nvm ( version control system for nodejs )

    wget -P /root/ --tries=10 --retry-connrefused --waitretry=60 --no-dns-cache --no-cache  https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh
bash /root/install.sh
. /root/.nvm/nvm.sh

  3. Install nodejs

    nvm install --lts=Erbium
nvm alias default lts/erbium
nvm use default

  4. Install yarn

    npm install -g yarn

Install and configure components

We will install the Skyline Console service from source code.

  1. Git clone the repository from OpenDev (GitHub)

    cd ${HOME}
git clone https://opendev.org/openstack/skyline-console.git

    Note

    If you meet the following error, you need to run command sudo apt install -y ca-certificates:

    fatal: unable to access 'https://opendev.org/openstack/skyline-sonsole.git/': server certificate verification failed. CAfile: none CRLfile: none

  2. Install skyline-console

    cd ${HOME}/skyline-console
make package
sudo pip3 install --force-reinstall dist/skyline_console-*.whl

  3. Ensure that skyline folders have been created

    sudo mkdir -p /etc/skyline /var/log/skyline

    Note

    Ensure that skyline.yaml file is available in /etc/skyline folder. For more information about skyline.yml, see OpenStack Skyline Settings.

  4. Generate nginx configuration file

    skyline-nginx-generator -o /etc/nginx/nginx.conf
sudo sed -i "s/server .* fail_timeout=0;/server 0.0.0.0:28000 fail_timeout=0;/g" /etc/nginx/nginx.conf

    Note

    We need to change the upstream skyline value in /etc/nginx/nginx.conf to 0.0.0.0:28000. Default value is unix:/var/lib/skyline/skyline.sock.

Finalize installation

Start nginx service

sudo systemctl start nginx.service
sudo systemctl enable nginx.service