Lack of clarity on networking

[Glenn Baxter]

In the page http://docs.openstack.org/havana/install-guide/install/apt/content/nova-network.html

The steps do not call out what commands are to be done on controller, and what is to be done on compute1 to computeX. Please add language such as

  "1. Install the appropriate packages for compute networking (on both compute nodes and controller nodes):"

as appropriate.

Networking is rather poorly documented in general, and it is very difficult for people to figure out what they are supposed to do to make it work. This is particularly true of the section on Neutron. Simple declarative statements like "compute nodes only" added on the above referenced URL will help clarify what does where. If you can not follow the directions and make it work (which I can not at present), then you will soon get sick of trying OpenStack.

-----------------------------------
Built: 2013-12-16T19:06:30 00:00
git SHA: ffcae01fe2e154e4a74fe7afc2a66976dfbf30e7
URL: http://docs.openstack.org/havana/install-guide/install/apt/content/nova-network.html
source File: file:/home/jenkins/workspace/openstack-install-deploy-guide-ubuntu/doc/install-guide/section_nova-network.xml
xml:id: nova-network

[Tom Fifield (fifieldt)]

Hi Glenn,

Thanks for the report. I'll add another clarifying note in the particular section mentioned.

However, just to try and save you - in the multi_host HA configuration used by this guide the nova-network package is only needed on the compute nodes, not the controller.

[Tom Fifield (fifieldt)]

and, also yes - many bugs lodged on the neutron section :( It is certainly the most problematic and I agree it is putting people off.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/62542

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/62542
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=ffa01a2c2314f16f25c7f0179c498297d2f0f9cc
Submitter: Jenkins
Branch: master

commit ffa01a2c2314f16f25c7f0179c498297d2f0f9cc
Author: Tom Fifield <email address hidden>
Date: Tue Dec 17 13:17:24 2013 +0800

    Add another clarifying note on nova-net install

    We had another bug report about the nova-network install section.

    This patch adds another very explicit,
    clarifying note to ensure people are installing
    packages in the right place.

    Change-Id: Ifc48813af9ec1cf8a87aab96c3f95c8d474595c9
    Closes-bug: 1261620

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/havana
Review: https://review.openstack.org/62745

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/62745
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=98d26ef58c3eedb0e96fcf902acadb3b5f955ca4
Submitter: Jenkins
Branch: stable/havana

commit 98d26ef58c3eedb0e96fcf902acadb3b5f955ca4
Author: Tom Fifield <email address hidden>
Date: Tue Dec 17 13:17:24 2013 +0800

    Add another clarifying note on nova-net install

    We had another bug report about the nova-network install section.

    This patch adds another very explicit,
    clarifying note to ensure people are installing
    packages in the right place.

    Change-Id: Ifc48813af9ec1cf8a87aab96c3f95c8d474595c9
    Closes-bug: 1261620
    (cherry picked from commit ffa01a2c2314f16f25c7f0179c498297d2f0f9cc)

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.