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

If your use Ubuntu 20.04 64 bit or Ubuntu 22.04 64 bit

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

If your use Ubuntu 24.04 64 bit

sudo apt update
sudo apt install git python3-pip nginx make ssl-cert
sudo apt install libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev libnss3 libxss1 libasound2t64 libxtst6 xauth xvfb

1. Install nvm (version control system for Node.js)

   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
   

2. Install nodejs

   nvm install --lts=gallium
   nvm alias default lts/gallium
   nvm use default
   

3. Check version node and npm

   node -v
   v16.*.*
   

   npm -v
   8.*.*
   

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 /root
   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 /root/skyline-console
   make package
   sudo python3 -m pip 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