From a6d9655d7806bade90cffcd107cd1e9ca1861f0f 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/compute-install-obs.rst | 5 +++++ doc/source/install/compute-install-rdo.rst | 5 +++++ doc/source/install/compute-install-ubuntu.rst | 5 +++++ doc/source/install/controller-install-obs.rst | 5 +++++ doc/source/install/controller-install-rdo.rst | 5 +++++ doc/source/install/controller-install-ubuntu.rst | 5 +++++ 6 files changed, 30 insertions(+) diff --git a/doc/source/install/compute-install-obs.rst b/doc/source/install/compute-install-obs.rst index 94a88477c4f5..84c662d4b524 100644 --- a/doc/source/install/compute-install-obs.rst +++ b/doc/source/install/compute-install-obs.rst @@ -123,6 +123,11 @@ Install and configure components firewall service 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/compute-install-obs.html#configure-the-compute-service-to-use-the-networking-service + * In the ``[vnc]`` section, enable and configure remote console access: .. path /etc/nova/nova.conf diff --git a/doc/source/install/compute-install-rdo.rst b/doc/source/install/compute-install-rdo.rst index 246bb2414742..b86a843f5cf6 100644 --- a/doc/source/install/compute-install-rdo.rst +++ b/doc/source/install/compute-install-rdo.rst @@ -115,6 +115,11 @@ Install and configure components service 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/compute-install-rdo.html#configure-the-compute-service-to-use-the-networking-service + * In the ``[vnc]`` section, enable and configure remote console access: .. path /etc/nova/nova.conf diff --git a/doc/source/install/compute-install-ubuntu.rst b/doc/source/install/compute-install-ubuntu.rst index e808c88bed13..0c8d0183829f 100644 --- a/doc/source/install/compute-install-ubuntu.rst +++ b/doc/source/install/compute-install-ubuntu.rst @@ -105,6 +105,11 @@ Install and configure components service 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/compute-install-ubuntu.html#configure-the-compute-service-to-use-the-networking-service + * In the ``[vnc]`` section, enable and configure remote console access: .. path /etc/nova/nova.conf diff --git a/doc/source/install/controller-install-obs.rst b/doc/source/install/controller-install-obs.rst index 336d13a10397..53534af323f4 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 75d7142301d7..a9972de3cf93 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 6c9da11ddc40..f9274c93b942 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: