128 lines
3.4 KiB
ReStructuredText
128 lines
3.4 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
|
|
|
|
If your use Ubuntu 20.04 64 bit or Ubuntu 22.04 64 bit
|
|
|
|
.. code-block:: shell
|
|
|
|
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
|
|
|
|
.. code-block:: shell
|
|
|
|
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
|
|
|
|
#. Install nvm (version control system for Node.js)
|
|
|
|
.. 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=gallium
|
|
nvm alias default lts/gallium
|
|
nvm use default
|
|
|
|
#. Check version node and npm
|
|
|
|
.. code:: shell
|
|
|
|
node -v
|
|
v16.*.*
|
|
|
|
.. code:: shell
|
|
|
|
npm -v
|
|
8.*.*
|
|
|
|
#. 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 /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`
|
|
|
|
#. Install skyline-console
|
|
|
|
.. code-block:: shell
|
|
|
|
cd /root/skyline-console
|
|
make package
|
|
sudo python3 -m pip 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
|
|
`OpenStack Skyline Settings <https://docs.openstack.org/skyline-apiserver/latest/configuration/settings.html>`__.
|
|
|
|
#. 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
|