Skip to content

Commit cae860c

Browse files
Jenkinsopenstack-gerrit
authored andcommitted
Merge "docs: merge multiple interface sections with provider network section"
2 parents 64be321 + 887f182 commit cae860c

1 file changed

Lines changed: 42 additions & 92 deletions

File tree

doc/source/guides/neutron.rst

Lines changed: 42 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -72,98 +72,6 @@ DevStack Configuration
7272

7373

7474

75-
76-
77-
Using Neutron with Multiple Interfaces
78-
======================================
79-
80-
The first interface, eth0 is used for the OpenStack management (API,
81-
message bus, etc) as well as for ssh for an administrator to access
82-
the machine.
83-
84-
::
85-
86-
stack@compute:~$ ifconfig eth0
87-
eth0 Link encap:Ethernet HWaddr bc:16:65:20:af:fc
88-
inet addr:192.168.1.18
89-
90-
eth1 is manually configured at boot to not have an IP address.
91-
Consult your operating system documentation for the appropriate
92-
technique. For Ubuntu, the contents of `/etc/network/interfaces`
93-
contains:
94-
95-
::
96-
97-
auto eth1
98-
iface eth1 inet manual
99-
up ifconfig $IFACE 0.0.0.0 up
100-
down ifconfig $IFACE 0.0.0.0 down
101-
102-
The second physical interface, eth1 is added to a bridge (in this case
103-
named br-ex), which is used to forward network traffic from guest VMs.
104-
Network traffic from eth1 on the compute nodes is then NAT'd by the
105-
controller node that runs Neutron's `neutron-l3-agent` and provides L3
106-
connectivity.
107-
108-
::
109-
110-
stack@compute:~$ sudo ovs-vsctl add-br br-ex
111-
stack@compute:~$ sudo ovs-vsctl add-port br-ex eth1
112-
stack@compute:~$ sudo ovs-vsctl show
113-
9a25c837-32ab-45f6-b9f2-1dd888abcf0f
114-
Bridge br-ex
115-
Port br-ex
116-
Interface br-ex
117-
type: internal
118-
Port phy-br-ex
119-
Interface phy-br-ex
120-
type: patch
121-
options: {peer=int-br-ex}
122-
Port "eth1"
123-
Interface "eth1"
124-
125-
126-
127-
128-
129-
Neutron Networking with Open vSwitch
130-
====================================
131-
132-
Configuring neutron, OpenStack Networking in DevStack is very similar to
133-
configuring `nova-network` - many of the same configuration variables
134-
(like `FIXED_RANGE` and `FLOATING_RANGE`) used by `nova-network` are
135-
used by neutron, which is intentional.
136-
137-
The only difference is the disabling of `nova-network` in your
138-
local.conf, and the enabling of the neutron components.
139-
140-
141-
Configuration
142-
-------------
143-
144-
::
145-
146-
FIXED_RANGE=10.0.0.0/24
147-
FLOATING_RANGE=192.168.27.0/24
148-
PUBLIC_NETWORK_GATEWAY=192.168.27.2
149-
150-
disable_service n-net
151-
enable_service q-svc
152-
enable_service q-agt
153-
enable_service q-dhcp
154-
enable_service q-meta
155-
enable_service q-l3
156-
157-
Q_USE_SECGROUP=True
158-
ENABLE_TENANT_VLANS=True
159-
TENANT_VLAN_RANGE=1000:1999
160-
PHYSICAL_NETWORK=default
161-
OVS_PHYSICAL_BRIDGE=br-ex
162-
163-
In this configuration we are defining FLOATING_RANGE to be a
164-
subnet that exists in the private RFC1918 address space - however in
165-
in a real setup FLOATING_RANGE would be a public IP address range.
166-
16775
Neutron Networking with Open vSwitch and Provider Networks
16876
==========================================================
16977

@@ -206,6 +114,48 @@ Physical Network Setup
206114
}
207115

208116

117+
On a compute node, the first interface, eth0 is used for the OpenStack
118+
management (API, message bus, etc) as well as for ssh for an
119+
administrator to access the machine.
120+
121+
::
122+
123+
stack@compute:~$ ifconfig eth0
124+
eth0 Link encap:Ethernet HWaddr bc:16:65:20:af:fc
125+
inet addr:10.0.0.3
126+
127+
eth1 is manually configured at boot to not have an IP address.
128+
Consult your operating system documentation for the appropriate
129+
technique. For Ubuntu, the contents of `/etc/network/interfaces`
130+
contains:
131+
132+
::
133+
134+
auto eth1
135+
iface eth1 inet manual
136+
up ifconfig $IFACE 0.0.0.0 up
137+
down ifconfig $IFACE 0.0.0.0 down
138+
139+
The second physical interface, eth1 is added to a bridge (in this case
140+
named br-ex), which is used to forward network traffic from guest VMs.
141+
142+
::
143+
144+
stack@compute:~$ sudo ovs-vsctl add-br br-ex
145+
stack@compute:~$ sudo ovs-vsctl add-port br-ex eth1
146+
stack@compute:~$ sudo ovs-vsctl show
147+
9a25c837-32ab-45f6-b9f2-1dd888abcf0f
148+
Bridge br-ex
149+
Port br-ex
150+
Interface br-ex
151+
type: internal
152+
Port phy-br-ex
153+
Interface phy-br-ex
154+
type: patch
155+
options: {peer=int-br-ex}
156+
Port "eth1"
157+
Interface "eth1"
158+
209159

210160
Service Configuration
211161
---------------------

0 commit comments

Comments
 (0)