Update install and configuration instructions

story: 2005166
Task: #29899

Change-Id: Ic2e76d4f054f1666726cfc1b4f2c945393d3c8a9
Signed-off-by: Tomi Juvonen <tomi.juvonen@nokia.com>
This commit is contained in:
Tomi Juvonen 2019-05-24 11:54:55 +03:00
parent 879d73ed78
commit 9994fbdac3
13 changed files with 149 additions and 69 deletions

View File

@ -0,0 +1,69 @@
Configuration files
-------------------
Configuration options. All options have default values. Mandatory options are
mentioned as those are usually at least the ones needed to be defined to match
to the current system.
* Edit the ``/etc/fenix/fenix-api.conf`` file the configure fenix-api
.. code-block:: ini
[DEFAULT]
#Mandatory configuration options
#Host where API is running. default="127.0.0.1"
host = <hostname>
#API Port. default=5000
port = <port>
#An URL representing the messaging driver to use and its full configuration.
transport_url = <transport URL>
* Edit the ``/etc/fenix/fenix.conf`` file the configure fenix-engine
.. code-block:: ini
[DEFAULT]
#Mandatory configuration options
#Host where engine is running. default="127.0.0.1"
host = <hostname>
#API Port. default=5000
port = <port>
#An URL representing the messaging driver to use and its full configuration.
transport_url = <transport URL>
#Optional configuration options
#Wait for project reply after message sent to project. default 120
wait_project_reply = 120
#Project maintenance reply confirmation time in seconds. default 40
project_maintenance_reply = 40
#Project scale in reply confirmation time in seconds. default 60
project_scale_in_reply = 60
#Number of live migration retries. default 5
live_migration_retries = 5
#How long to wait live migration to be done. default 600
live_migration_wait_time = 600
[database]
#database connection URL
connection = mysql+pymysql://fenix:FENIX_DBPASS@controller/fenix
[service_user]
#OpenStack Identity service URL. Default to environmental variable OS_AUTH_URL
os_auth_url
#Fenix user. Must have admin role. Default to environmental variable OS_USERNAME
os_username
#Fenix admin user password. Default to environmental variable OS_PASSWORD
os_password
#A domain name the os_username belongs to. Default to environmental variable OS_USER_DOMAIN_NAME
os_user_domain_name
#The Fenix admin project. Default to environmental variable OS_PROJECT_NAME
os_project_name
#The Fenix admin project domain. Default to environmental variable OS_PROJECT_DOMAIN_NAME
os_project_domain_name

View File

@ -2,4 +2,18 @@
Configuration
=============
Configuration of fenix.
.. toctree::
:maxdepth: 2
configuration.rst
Dependencies and special configuration
======================================
Fenix Default workflow VNFM interaction also assumes AODH is installed.
Among that, here is mentioned what you may want to configure when using Fenix.
.. toctree::
:maxdepth: 2
../configuration/dependensies.rst

View File

@ -1,10 +0,0 @@
2. Edit the ``/etc/fenix/fenix.conf`` file and complete the following
actions:
* In the ``[database]`` section, configure database access:
.. code-block:: ini
[database]
...
connection = mysql+pymysql://fenix:FENIX_DBPASS@controller/fenix

View File

@ -63,6 +63,11 @@ you must create a database, service credentials, and API endpoints.
$ openstack service create --name fenix --description "fenix" fenix
Note! In Fenix workflow you may want to have ssh access to all nodes for
your Fenix action plug-ins to scp filex and locally execute scripts on
those nodes. This means you may want to have the ssh without password
configured for Fenix service user.
#. Create the fenix service API endpoints:
.. code-block:: console
@ -73,3 +78,15 @@ you must create a database, service credentials, and API endpoints.
fenix internal http://controller:XXXX/vY/%\(tenant_id\)s
$ openstack endpoint create --region RegionOne \
fenix admin http://controller:XXXX/vY/%\(tenant_id\)s
Installation
------------
Note! Fenix is not currently included to Linux distros.
You need to clone and install from source.
.. code-block:: console
$ git clone https://opendev.org/x/fenix
$ cd fenix
$ sudo python setup.py install

View File

@ -6,4 +6,7 @@ The fenix service provides...
The fenix service consists of the following components:
``fenix-api`` service
Accepts and responds to end user compute API calls...
Accepts and responds to end user API calls
``fenix-engine`` service
Runs the pluggable maintenance sessions

View File

@ -0,0 +1,18 @@
.. _install-devstack:
Install and configure for DevStack
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Install and configure components
--------------------------------
#. Install Fenix by adding needed options to local.conf
.. code-block:: ini
#Enable Fenix plugin
enable_plugin fenix https://opendev.org/x/fenix
#Enable Fenix services
enable_service fenix-engine
enable_service fenix-api

View File

@ -5,21 +5,11 @@ Install and configure for openSUSE and SUSE Linux Enterprise
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the fenix service
for openSUSE Leap 42.1 and SUSE Linux Enterprise Server 12 SP1.
for openSUSE and SUSE Linux Enterprise Server.
.. include:: common_prerequisites.rst
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
# zypper --quiet --non-interactive install
.. include:: common_configure.rst
.. include:: ../configuration/configuration.rst
Finalize installation
---------------------
@ -28,7 +18,9 @@ Start the fenix services and configure them to start when
the system boots:
.. code-block:: console
# systemctl enable openstack-fenix-api.service
# systemctl start openstack-fenix-api.service
# systemctl enable openstack-fenix-engine.service
# systemctl start openstack-fenix-engine.service

View File

@ -5,20 +5,11 @@ Install and configure for Red Hat Enterprise Linux and CentOS
This section describes how to install and configure the fenix service
for Red Hat Enterprise Linux 7 and CentOS 7.
for Red Hat Enterprise Linux and CentOS.
.. include:: common_prerequisites.rst
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
# yum install
.. include:: common_configure.rst
.. include:: ../configuration/configuration.rst
Finalize installation
---------------------
@ -29,5 +20,7 @@ the system boots:
.. code-block:: console
# systemctl enable openstack-fenix-api.service
# systemctl start openstack-fenix-api.service
# systemctl enable openstack-fenix-engine.service
# systemctl start openstack-fenix-engine.service

View File

@ -4,22 +4,11 @@ Install and configure for Ubuntu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the fenix
service for Ubuntu 14.04 (LTS).
service for Ubuntu.
.. include:: common_prerequisites.rst
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
# apt-get update
# apt-get install
.. include:: common_configure.rst
.. include:: ../configuration/configuration.rst
Finalize installation
---------------------
@ -29,3 +18,4 @@ Restart the fenix services:
.. code-block:: console
# service openstack-fenix-api restart
# service openstack-fenix-fenix restart

View File

@ -7,14 +7,17 @@ This section describes how to install and configure the
fenix service, code-named fenix, on the controller node.
This section assumes that you already have a working OpenStack
environment with at least the following components installed:
.. (add the appropriate services here and further notes)
environment.
Note that installation and configuration vary by distribution.
Currently Fenix is not included in any distributions. Instead
there is shown the generic way of installing and how to install
via DevStack.
.. toctree::
:maxdepth: 2
install-obs.rst
install-rdo.rst
install-ubuntu.rst
install-ubuntu.rst
install-obs.rst
install-devstack.rst

View File

@ -3,7 +3,5 @@
Next steps
~~~~~~~~~~
Your OpenStack environment now includes the fenix service.
To add additional services, see
https://docs.openstack.org/project-install-guide/ocata/.
Latest activites are tracked in wiki page:
https://wiki.openstack.org/wiki/Fenix

View File

@ -9,16 +9,9 @@ Verify operation of the fenix service.
Perform these commands on the controller node.
#. Source the ``admin`` project credentials to gain access to
admin-only CLI commands:
.. code-block:: console
$ . admin-openrc
#. List service components to verify successful launch and registration
of each process:
of each process. Example for DevStack:
.. code-block:: console
$ openstack fenix service list
$ sudo systemctl status devstack@fenix*

View File

@ -4,4 +4,4 @@ Usage
To use fenix in a project::
import fenix
TBD