105 lines
2.8 KiB
ReStructuredText
105 lines
2.8 KiB
ReStructuredText
.. _source-install-ubuntu:
|
|
|
|
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
|
|
<https://docs.openstack.org/skyline-apiserver/latest/install/source-install-ubuntu.html>`__.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
#. Install system dependencies
|
|
|
|
.. code-block:: shell
|
|
|
|
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
|
|
|
|
#. Install nvm ( version control system for nodejs )
|
|
|
|
.. code:: shell
|
|
|
|
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
|
|
|
|
#. Install nodejs
|
|
|
|
.. code:: shell
|
|
|
|
nvm install --lts=Erbium
|
|
nvm alias default lts/erbium
|
|
nvm use default
|
|
|
|
#. Install yarn
|
|
|
|
.. code:: shell
|
|
|
|
npm install -g yarn
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
We will install the Skyline Console service from source code.
|
|
|
|
#. Git clone the repository from OpenDev (GitHub)
|
|
|
|
.. code-block:: shell
|
|
|
|
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`
|
|
|
|
#. Install skyline-console
|
|
|
|
.. code-block:: shell
|
|
|
|
cd ${HOME}/skyline-console
|
|
make package
|
|
sudo pip3 install --force-reinstall dist/skyline_console-*.whl
|
|
|
|
#. Ensure that skyline folders have been created
|
|
|
|
.. code-block:: shell
|
|
|
|
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 :ref:`skyline-settings`.
|
|
|
|
#. Generate nginx configuration file
|
|
|
|
.. code-block:: shell
|
|
|
|
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
|
|
|
|
.. code-block:: shell
|
|
|
|
sudo systemctl start nginx.service
|
|
sudo systemctl enable nginx.service
|