Horizon dashboard to diagnose OpenStack networking issues.
Go to file
OpenDev Sysadmins 882149f89e OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
2019-04-19 19:51:19 +00:00
doc/source Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
etc/don Adding DON changes to the repo 2016-08-01 10:06:44 +00:00
images Added DON schematic to README 2016-08-07 22:48:50 +05:30
openstack_dashboard Libvirt instance parser 2016-11-18 12:49:38 +02:00
releasenotes Enable release notes translation 2016-10-06 20:49:28 +02:00
static/don Adding DON changes to the repo 2016-08-01 10:06:44 +00:00
.coveragerc Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
.gitignore Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:51:19 +00:00
.mailmap Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
.testr.conf Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
CONTRIBUTING.rst Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
HACKING.rst Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
LICENSE Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
MANIFEST.in Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
README.md Add Devstack commands 2017-05-04 13:06:16 -05:00
babel.cfg Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
don_playbook.yaml Added ansible playbook and updated README 2016-08-02 10:04:49 +05:30
requirements.txt Adding DON changes to the repo 2016-08-01 10:06:44 +00:00
setup.cfg Adding README file 2016-08-01 11:43:33 +00:00
setup.py Initial commit with cookiecutter project template 2016-08-01 06:07:26 +00:00
test-requirements.txt Add test for ovs collector module and modify collector 2016-10-08 18:33:39 +03:00
tox.ini Cleanup tox.ini: Remove obsolete constraints 2016-08-26 18:12:57 +02:00

README.md

DON: Diagnosing OpenStack Networking

An OpenStack Horizon dashboard to diagnose OpenStack networking issues.

Overview

[Presented in the OpenStack Liberty Summit, Vancouver, May, 2015] (https://www.openstack.org/summit/vancouver-2015/summit-videos/presentation/don-diagnosing-ovs-in-neutron "DON Presentation at OpenStack Liberty Summit, Vancouver, May 2015").

A lot has changed since Vancouver! Support for multi-node OpenStack installations and complete integrated with Horizon, Liberty release are among the things to look forward to.

Neutron provides Networking-as-a-service in the OpenStack ecosystem. Networking functionalities are provided by plugins that implement well-defined Neutron APIs. Among many, the Open vSwitch plugin (OVS) is possibly the most widely used. Any practical OpenStack installation has complicated networking configuration and verifying it manually is time consuming and error prone. DON, written primarily in Python, and available as a dashboard in OpenStack Horizon, Libery release, is a network analysis and diagnostic system and provides a completely automated service for verifying and diagnosing the networking functionality provided by OVS. This service verifies (or points out deviations) that the user configuration is indeed reflected in the underlying infrastructure and presents the results in an intuitive graphical display.

Feature Lists:

  1. Visualize networking internals
  2. Perform OVS and Ping tests between all pairs of VMs
  3. Perform Ping tracing between any two VMs
  4. Allows storing collected data so that it can be retrieved later and displayed

As an example, given the following Neutron network topology: Neutron: Network Topology

DON generates the following view of the networking internals, DON: Internal View

does OVS tests and ping tests, DON: Analysis

and also allows the user to do ping tracing DON: Ping Tracer

DON Schematic

DON first collects the output of several commands, parses the output, and creates a JSON database. This database is then used by the analyzer module, the visualizer module, and the test module. DON Schematic

How to Run:

Prerequisites:

  • Django version must be 1.7 or later. However, since OpenStack Horizon uses Django, there is no need to separately install Django.

  • The Graphviz dot utility. This is used for drawing the visualization.

Steps for DevStack:

  1. You must have a devstack setup running on a single VM.
  2. Download and source the project specific rc file. .. code-block:: shell $ git clone https://github.com/openstack/python-don.git
  3. Copy openstack_dashboard/, static/ directories from DON source to Horizon directory.(/opt/stack/horizon/) .. code-block:: shell $ cp -R python-don/openstack_dashboard/don /opt/stack/horizon/openstack_dashboard/
  4. Copy etc/don/ from DON source to /etc .. code-block:: shell

    mkdir /etc/don

    chown stack:root /etc/don

    cp etc/don/don.conf /etc/don/

    chown -R stack:stack /etc/don/don.conf

  5. Edit /etc/don/don.conf and change deployment_type=devstack under [DEFAULT] section. .. code-block:: shell

    sed -i "s/deployment_type=multinode/deployment_type=devstack/" /etc/don/don.conf

  6. To allow DON to do Ping tests between all pairs of VMs, configure VM credentials manually into /opt/stack/horizon/openstack_dashboard/don/ovs/credentials.yaml
  7. Compress django javascript libraries .. code-block:: shell $ DJANGO_SETTINGS_MODULE=openstack_dashboard.settings django-admin compress --force
  8. Restart Horizon by executing sudo service apache2 restart

Steps for Multinode Openstack:

  1. You must have Ansible (version 2.0 or later) installed in execution server
  2. Clone DON source to execution server
  3. Open shell prompt and execute the below command from DON directory
  4. ansible-playbook don_playbook.yaml -i <inventory file path> --ask-pass