fuel-specs/specs/9.0/support-qos.rst
Igor Kalnitsky 6ec0b000dd
Use docutils AST for making smart checks
Trying to enable testing specs for 9.0, we've encountered different
unavoidable problems with existing checks. For example, it was
impossible to have code blocks with line length more than 80 characters.

This commit uses docutils and make those changes using AST, so we can
avoid some checks for code-blocks or long links.

Closes-Bug: #1569929
Change-Id: Ia501754922b3272acd1a865513d5dffa17981331
2016-04-19 10:29:52 +03:00

218 lines
4.0 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

..
This work is licensed under a Creative Commons Attribution 3.0 Unported
License.
http://creativecommons.org/licenses/by/3.0/legalcode
======================================
Enable QoS support for tenant networks
======================================
https://blueprints.launchpad.net/fuel/+spec/support-qos
Administrator should be able to enable Network QoS for OVS and SR-IOV ML2
drivers. Also administrator should be able to assign policy creation rights to
a user or set up the policies on user behalf. Policy should effectively control
the network traffic on per virtual interface basis.
--------------------
Problem description
--------------------
QoS is defined as the ability to guarantee certain network requirements like
bandwidth, latency, jitter, and reliability in order to satisfy a SLA between
an application provider and end users. This feature is already implemented in
OpenStack Liberty, but requires simple changes in puppets to make it toggled
in Fuel 9.0.
This feature has several restrictions at the moment:
* Compatible only with two ML2 backends: OVS and SR-IOV
* Only egress bandwidth limit rules are supported
----------------
Proposed changes
----------------
Enabling QoS requires changes in Neutron configuration files:
On server side:
* Enable qos service in service_plugins.
* Set the message_queue driver for notification_drivers in [qos] section.
* For ml2, add qos to extension_drivers in [ml2] section.
On agent side (OVS):
* Add qos to extensions in [agent] section.
Web UI
======
In Neutron Advanced Configuration section a checkbox will be added to enable
QoS.
Nailgun
=======
Nailgun-agent
-------------
None
Bootstrap
---------
None
Data model
----------
::
neutron_advanced_configuration:
neutron_qos: false
REST API
--------
None
Orchestration
=============
None
RPC Protocol
------------
Only payload changes
Fuel Client
===========
None
Plugins
=======
None
Fuel Library
============
See items in Proposed changes section.
------------
Alternatives
------------
None
--------------
Upgrade impact
--------------
None
---------------
Security impact
---------------
By default QoS policies and rules will be managed by the cloud administrator,
that makes the tenant unable to create specific qos rules, or attaching
specific ports to policies.
--------------------
Notifications impact
--------------------
None
---------------
End user impact
---------------
Additional Neutron CLI commands will be enabled as it's described here:
http://specs.openstack.org/openstack/neutron-specs/specs/liberty/qos-api-extension.html#other-end-user-impact
------------------
Performance impact
------------------
Minimal. Additional messaging calls will be created during updating and
creating Neutron networks and ports.
-----------------
Deployment impact
-----------------
None
----------------
Developer impact
----------------
None
---------------------
Infrastructure impact
---------------------
None
--------------------
Documentation impact
--------------------
TBD
--------------
Implementation
--------------
Assignee(s)
===========
Primary assignee:
skolekonov <skolekonov@mirantis.com>
Mandatory design review:
yottatsa <veremin@mirantis.com>
Work Items
==========
* Enable QoS configuration in fuel-library
* UI changes by configuring only openstack.yaml
* Manual testing
Dependencies
============
None
------------
Testing, QA
------------
* Automated API/CLI test cases for the configuring QoS rules and polices
* Automated functional testing of QoS for OVS and SR-IOV backends
* Testing QoS rules and policies life-cycle on scale
Acceptance criteria
===================
* User should be able to create, update and delete QoS rules and policies for
OVS and SR-IOV ML2 drivers..
* Bandwith limiting on egress interfaces corresponds to QoS configuration
----------
References
----------
* `Using QoS functionality
<http://docs.openstack.org/liberty/networking-guide/adv-config-qos.html>`_