From e255fcfc32472ffe6846a9246896b8b676741e9e Mon Sep 17 00:00:00 2001 From: Matt Riedemann Date: Thu, 5 Apr 2018 11:50:25 -0400 Subject: [PATCH] doc: add a link in the install guides about configuring neutron It is not uncommon to triage bugs on a weekly basis where the [neutron] auth credentials are not configured in nova.conf, which generally leads to a 500 response in the compute API because of the auth error. With respect to neutron, the compute install guides really only say to set use_neutron=True, but don't mention that configuring the [neutron] section for auth is required. The networking service install guide does, so it's a bit confusing why people make this mistake in the first place, but as a reminder, this change adds links from the compute install guide to the relevant sections in the networking service install guides. Change-Id: Id17457bd2770fcbebd6231919ba4002e75410089 Closes-Bug: #1761487 --- doc/source/install/controller-install-obs.rst | 5 +++++ doc/source/install/controller-install-rdo.rst | 5 +++++ doc/source/install/controller-install-ubuntu.rst | 5 +++++ 3 files changed, 15 insertions(+) diff --git a/doc/source/install/controller-install-obs.rst b/doc/source/install/controller-install-obs.rst index 336d13a10..53534af32 100644 --- a/doc/source/install/controller-install-obs.rst +++ b/doc/source/install/controller-install-obs.rst @@ -380,6 +380,11 @@ Install and configure components Compute firewall driver by using the ``nova.virt.firewall.NoopFirewallDriver`` firewall driver. + * Configure the ``[neutron]`` section of **/etc/nova/nova.conf**. See the + `Networking service install guide`__ for more details. + + .. __: https://docs.openstack.org/neutron/latest/install/controller-install-obs.html#configure-the-compute-service-to-use-the-networking-service + * In the ``[vnc]`` section, configure the VNC proxy to use the management interface IP address of the controller node: diff --git a/doc/source/install/controller-install-rdo.rst b/doc/source/install/controller-install-rdo.rst index 75d714230..a9972de3c 100644 --- a/doc/source/install/controller-install-rdo.rst +++ b/doc/source/install/controller-install-rdo.rst @@ -370,6 +370,11 @@ Install and configure components Compute firewall driver by using the ``nova.virt.firewall.NoopFirewallDriver`` firewall driver. + * Configure the ``[neutron]`` section of **/etc/nova/nova.conf**. See the + `Networking service install guide`__ for more details. + + .. __: https://docs.openstack.org/neutron/latest/install/controller-install-rdo.html#configure-the-compute-service-to-use-the-networking-service + * In the ``[vnc]`` section, configure the VNC proxy to use the management interface IP address of the controller node: diff --git a/doc/source/install/controller-install-ubuntu.rst b/doc/source/install/controller-install-ubuntu.rst index 6c9da11dd..f9274c93b 100644 --- a/doc/source/install/controller-install-ubuntu.rst +++ b/doc/source/install/controller-install-ubuntu.rst @@ -360,6 +360,11 @@ Install and configure components Compute firewall driver by using the ``nova.virt.firewall.NoopFirewallDriver`` firewall driver. + * Configure the ``[neutron]`` section of **/etc/nova/nova.conf**. See the + `Networking service install guide`__ for more details. + + .. __: https://docs.openstack.org/neutron/latest/install/controller-install-ubuntu.html#configure-the-compute-service-to-use-the-networking-service + * In the ``[vnc]`` section, configure the VNC proxy to use the management interface IP address of the controller node: