Docs: Troubleshooting info for 3.13 kernel upgrade

Add a note to the OSA Operations Guide about the need to re-run the
hosts setup playbook after a kernel upgrade from v3.13. This patch also
incidentally moves the introductory section text to be above the TOC.

Change-Id: Ia04cec6c689d02bff98a6adb623914703b9e3f7b
Closes-Bug: 1579963
This commit is contained in:
Robb Romans
2016-05-17 12:46:52 -05:00
parent 12d9ef21ea
commit fbd1f3fae1
2 changed files with 17 additions and 4 deletions

View File

@@ -4,6 +4,19 @@
Troubleshooting Troubleshooting
=============== ===============
Host kernel upgrade from version 3.13
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Ubuntu kernel packages newer than version 3.13 contain a change in
module naming from ``nf_conntrack`` to ``br_netfilter``. After
upgrading the kernel, re-run the ``openstack-hosts-setup.yml``
playbook against those hosts. See `OSA bug 157996`_ for more
information.
.. _OSA bug 157996: https://bugs.launchpad.net/openstack-ansible/+bug/1579963
Container networking issues Container networking issues
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -77,7 +90,7 @@ Examples of the information gathered are:
* Linux distribution * Linux distribution
* Kernel version * Kernel version
* Network interfaces * Network interfaces
To improve performance, particularly in large deployments, you can To improve performance, particularly in large deployments, you can
cache host facts and information. cache host facts and information.

View File

@@ -4,6 +4,9 @@
Chapter 8. Operations Chapter 8. Operations
===================== =====================
The following operations and troubleshooting procedures apply to
installed environments.
.. toctree:: .. toctree::
ops-addcomputehost.rst ops-addcomputehost.rst
@@ -12,9 +15,6 @@ Chapter 8. Operations
ops-troubleshooting.rst ops-troubleshooting.rst
The following operations apply to environments after initial
installation.
-------------- --------------
.. include:: navigation.txt .. include:: navigation.txt