openstack/nova
Code Issues Proposed changes

doc: add a link in the install guides about configuring neutron

Browse Source 
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
This commit is contained in:
Matt Riedemann 2018-04-05 11:50:25 -04:00
parent 587eb4303b
commit a6d9655d78
6 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/source/install/compute-install-obs.rst
View File

@ -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

5
doc/source/install/compute-install-rdo.rst
View File

@ -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

5
doc/source/install/compute-install-ubuntu.rst
View File

@ -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

5
doc/source/install/controller-install-obs.rst
View File

@ -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:

5
doc/source/install/controller-install-rdo.rst
View File

@ -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:

5
doc/source/install/controller-install-ubuntu.rst
View File

@ -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: