Bug 1034476

Description of problem:

The documentation at http://openstack.redhat.com/Quickstart assumes use of nova-network instead of neutron which the Havana release of RDO now appears to configure by default.  Instances cannot reach the external network and points beyond it without first adding the external physical network interface on the host (e.g., eth0) as a port on br-ex using ovs-vsctl.  For example:

ovs-vsctl add-port br-ex eth0

For installations with a single network interface handling both management and instance traffic, adding the latter to br-ex will interrupt network connectivity until one moves the IP address (e.g., 192.168.1.101) from the original interface to br-ex.  After moving the IP address, the host should regain network connectivity and the instance should be able to reach some IP address outside of the internal/fixed network.

The documentation should mention this additional configuration and the temporary interruption of network connectivity.  Also, it should include the necessary changes to the associated network interface configuration files in /etc/sysconfig/network-scripts.  For example:

/etc/sysconfig/network-scripts/ifcfg-br-ex:

DEVICE="br-ex"
DEVICETYPE="ovs"
TYPE="OVSBridge"
BOOTPROTO="static"
IPADDR="192.168.1.101"
NETMASK="255.255.255.0"
GATEWAY="192.168.1.1"
ONBOOT="yes"

/etc/sysconfig/network-scripts/ifcfg-eth0:

DEVICE="eth0"
BOOTPROTO="none"
TYPE="OVSPort"
DEVICETYPE="ovs"
OVS_BRIDGE="br-ex"
ONBOOT="yes"

Steps to Reproduce:
1. Install the Havana release of RDO.
2. Launch an instance with the default configuration.
3. Open console to instance.
4. Run 'ping' to some IP address outside of the internal/fixed network.

Actual results:

Ping fails.

Expected results:

Ping succeeds.

Additional info: