Docs: Fix missing instructions for newton manual upgrades

If the deployer follows current manual instructions, he will miss a few
steps, which will cause issues in the upgrade.

Change-Id: Ia9db77e5c05974b57abdca744373d8906ddd3ddb
Fixes-Bug: 1592067
Signed-off-by: Jean-Philippe Evrard <jean-philippe.evrard@rackspace.co.uk>
(cherry picked from commit 465d76e563)

doc/source/upgrade-guide/manual-upgrade.rst

@@ -57,6 +57,18 @@ inventory is found automatically.
 
     # cd playbooks
 
+Cleanup old facts
+~~~~~~~~~~~~~~~~~
+
+Some configuration changed, and old facts should be purged before
+the upgrade.
+
+See :ref:`fact-cleanup-playbook` for more details.
+
+.. code-block:: console
+
+    # openstack-ansible "${UPGRADE_PLAYBOOKS}/ansible_fact_cleanup.yml"
+
 Update configuration and environment files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -123,7 +135,7 @@ See :ref:`repo-server-pip-conf-removal` for more details.
     # openstack-ansible "${UPGRADE_PLAYBOOKS}/repo-server-pip-conf-removal.yml"
 
 Ensure hostname aliases are created for non-RFC1034/35 hostnames
-----------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Ensure an alias is created for non-RFC1034/35 hostnames.
 
@@ -149,6 +161,15 @@ See :ref:`setup-infra-playbook` for details.
     # openstack-ansible setup-infrastructure.yml -e 'galera_upgrade=true' \
     -e 'rabbitmq_upgrade=true'
 
+Flush Memcached cache
+~~~~~~~~~~~~~~~~~~~~~
+
+See :ref:`memcached-flush` for details.
+
+.. code-block:: console
+
+    # openstack-ansible "${UPGRADE_PLAYBOOKS}/memcached-flush.yml"
+
 Upgrade OpenStack
 ~~~~~~~~~~~~~~~~~
 

doc/source/upgrade-guide/upgrade-playbooks.rst

@@ -8,6 +8,13 @@ Within the main :file:`scripts` directory there is an :file:`upgrade-utilities`
 directory, which contains an additional playbooks directory. These playbooks
 facilitate the upgrade process.
 
+.. _fact-cleanup-playbook:
+
+``ansible_fact_cleanup.yml``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This calls a script to removes files in ``/etc/openstack_deploy/ansible_facts/``
+
 .. _config-change-playbook:
 
 ``deploy-config-changes.yml``
@@ -81,6 +88,13 @@ upgrade RabbitMQ.
 The ``galera_upgrade`` variable tells the ``galera_server`` role to remove the
 current version of MariaDB and Galera and upgrade to the 10.x series.
 
+.. _memcached-flush:
+
+``memcached-flush.yml``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Sends "flush_all" to memcached with the help of nc.
+
 --------------
 
 .. include:: navigation.txt