instructions on the page will never work

Bug #1392121 reported by Nathan
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
Medium
Matt Kassawara

Bug Description

The instructions on this page for the Network / Open Stack Networking (neutron) will never work properly.

They clearly state that only a single management network should be defined on the controller node. hovering over the definition of management network says it is clearly not an internet connected network. Then after the network is setup, the instructions say that the controller should attempt to ping a site on the internet. Since we only gave this machine a single interface, and that interface is on a non internet connected management network, the ping will never work.

The same thing applies to the compute node and the network node. They have management interfaces and internal interfaces, but are never given an interface with the ability to connect to the internet; however after setup the guide says to ping the internet with these machines. It will not work due to the lack of an interface connected to the internet.

-----------------------------------
Built: 2014-11-12T07:06:50 00:00
git SHA: 81e96746682421ca3a230ea1c9cbecea37dbe626
URL: http://docs.openstack.org/trunk/install-guide/install/apt/content/ch_basic_environment.html
source File: file:/home/jenkins/workspace/openstack-manuals-tox-doc-publishdocs/doc/install-guide/ch_basic_environment.xml
xml:id: ch_basic_environment

Revision history for this message
Tom Fifield (fifieldt) wrote :

Thanks Nathan - at quick glance, you're quite right.

We really appreciate this kind of bug report challenging the assumptions in the guide, as we've been staring at it for so long the problems become difficult for us to see :)

Changed in openstack-manuals:
milestone: none → kilo
importance: Undecided → Medium
status: New → Confirmed
tags: added: install-guide
Revision history for this message
Matt Kassawara (ionosphere80) wrote :

Installing the OS, updating it, and installing OpenStack packages on each node requires internet access. Hence, the assumption that the nodes can access the internet through at least one interface.

Changed in openstack-manuals:
assignee: nobody → Matt Kassawara (ionosphere80)
Revision history for this message
Pranav Salunke (dguitarbite) wrote :

You need another network or provide internet connection to the management network. We may need to update the docs by adding this to it.

Revision history for this message
Tom Fifield (fifieldt) wrote :

We could just say something along the lines of "make the internet work, we don't care how" ;) Explicitly adding an extra NIC would raise the complexity level ...

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (master)

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

Changed in openstack-manuals:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

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

commit 38054a08d09089b829f483971af65948c1bb90ab
Author: Matthew Kassawara <email address hidden>
Date: Tue Nov 25 14:54:51 2014 -0600

    Explicitly mention internet access for nodes

    I added a note to explicitly mention internet access
    requirements for nodes.

    Change-Id: I523eb23e57340ad25a98bb275c585ffcbe7abbfe
    Closes-Bug: #1392121
    backport: juno

Changed in openstack-manuals:
status: In Progress → Fix Released
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (stable/juno)

Fix proposed to branch: stable/juno
Review: https://review.openstack.org/137436

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (stable/juno)

Reviewed: https://review.openstack.org/137436
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=5595fde364e55699d2bf5e7b0aabdf9cdd154f00
Submitter: Jenkins
Branch: stable/juno

commit 5595fde364e55699d2bf5e7b0aabdf9cdd154f00
Author: Matthew Kassawara <email address hidden>
Date: Tue Nov 25 14:54:51 2014 -0600

    Explicitly mention internet access for nodes

    I added a note to explicitly mention internet access
    requirements for nodes.

    Change-Id: I523eb23e57340ad25a98bb275c585ffcbe7abbfe
    Closes-Bug: #1392121
    backport: juno
    (cherry picked from commit 38054a08d09089b829f483971af65948c1bb90ab)

tags: added: in-stable-juno
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/openstack-manuals 15.0.0

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

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.