====================
Settings / OpenStack
====================

.. contents:: :local:

.. _openstack-settings-credentials:

Credentials
===========

In this section you can configure the required settings in order to be able to connect to OpenStack

.. image:: /_static/images/newstaff/settings/openstack/openstack-credentials.png
    :scale: 50%

.. _openstack-settings-notifications:

Notifications
=============

In this section you can configure OpenStack notification settings. Fleio needs some notifications from
OpenStack in order to be able to function correctly. You can configure notification directly via OpenStack
messaging server (usually RabbitMQ) or you can use Fleio collector.

Make sure you :ref:`enable OpenStack notifications<enable-openstack-notifications>` and you :ref:`add the RabbitMQ
user<openstack-notifications-url>` for Fleio.

.. important::

    Test connections button from the Notifications tab does not confirm that RabbitMQ messages are received by
    Fleio. This only confirms that Fleio can connect and authenticate to the provided RabbitMQ URL(s). The test if
    notifications are working, please see :ref:`troubleshoot-openstack-notifications`.

.. image:: /_static/images/newstaff/settings/openstack/openstack-notifications.png
    :scale: 50%

.. _openstack-settings-defaults:


Defaults
========

Various other defaults required for Fleio to function properly with OpenStack

.. image:: /_static/images/newstaff/settings/openstack/openstack-defaults.png
    :scale: 50%


.. _openstack-settings-volume-increments:


Volume size increments
======================

This is the step size that can be used when extending a volume for a particular region.

The default value is 1 GB for every volume type.

This value is somewhat representative as the default OpenStack behaviour is to automatically round up the
volume size if invalid values are provided.

.. image:: /_static/images/newstaff/settings/openstack/settings-openstack-volume-size-increments.png
    :scale: 50%


.. _openstack-settings-discovered-services:


Discovered services
===================

In this section you can see a list of all discovered services and if they are supported by Fleio along
with minimum and maximum version supported. If the service is not found (for example load-balancer) or the
found version is not supported, you will see a red exclamation mark at the end of the row.

.. image:: /_static/images/staff/settings-openstack-discovered-services.png
    :scale: 50%

.. note:: More details on setting up Fleio for OpenStack are located :doc:`here </configuring/setup-fleio>`