~corey.bryant/charms/trusty/neutron-gateway/git-ods

« back to all changes in this revision

Viewing changes to README.md

  • Committer: Corey Bryant
  • Date: 2015-05-12 12:05:35 UTC
  • mfrom: (103.2.12 neutron-gateway)
  • Revision ID: corey.bryant@canonical.com-20150512120535-hwc39ua69mf7jnpo
Merge next branch

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
Neutron supports a rich plugin/extension framework for propriety networking
15
15
solutions and supports (in core) Nicira NVP, NEC, Cisco and others...
16
16
 
17
 
The Openstack charms currently only support the fully free OpenvSwitch plugin
18
 
and implements the 'Provider Router with Private Networks' use case.
19
 
 
20
17
See the upstream [Neutron documentation](http://docs.openstack.org/trunk/openstack-network/admin/content/use_cases_single_router.html)
21
18
for more details.
22
19
 
23
 
 
24
20
Usage
25
21
-----
26
22
 
40
36
 
41
37
The Neutron Gateway can then be added to the deploying:
42
38
 
43
 
    juju deploy quantum-gateway
44
 
    juju add-relation quantum-gateway mysql
45
 
    juju add-relation quantum-gateway rabbitmq-server
46
 
    juju add-relation quantum-gateway nova-cloud-controller
 
39
    juju deploy neutron-gateway
 
40
    juju add-relation neutron-gateway mysql
 
41
    juju add-relation neutron-gateway rabbitmq-server
 
42
    juju add-relation neutron-gateway nova-cloud-controller
47
43
 
48
44
The gateway provides two key services; L3 network routing and DHCP services.
49
45
 
60
56
If the port to be used for external traffic is consistent accross all physical
61
57
servers then is can be specified by simply setting ext-port to the nic id:
62
58
 
63
 
    quantum-gateway:
 
59
    neutron-gateway:
64
60
        ext-port: eth2
65
61
 
66
62
However, if it varies between hosts then the mac addresses of the external
67
63
nics for each host can be passed as a space seperated list:
68
64
 
69
 
    quantum-gateway:
 
65
    neutron-gateway:
70
66
        ext-port: <MAC ext port host 1> <MAC ext port host 2> <MAC ext port host 3>
71
67
 
72
68
 
74
70
=======================
75
71
 
76
72
If multiple floating pools are needed then an L3 agent (which corresponds to
77
 
a quantum-gateway for the sake of this charm) is needed for each one. Each
 
73
a neutron-gateway for the sake of this charm) is needed for each one. Each
78
74
gateway needs to be deployed as a seperate service so that the external
79
75
network id can be set differently for each gateway e.g.
80
76
 
81
 
    juju deploy quantum-gateway quantum-gateway-extnet1
82
 
    juju add-relation quantum-gateway-extnet1 mysql
83
 
    juju add-relation quantum-gateway-extnet1 rabbitmq-server
84
 
    juju add-relation quantum-gateway-extnet1 nova-cloud-controller
85
 
    juju deploy quantum-gateway quantum-gateway-extnet2
86
 
    juju add-relation quantum-gateway-extnet2 mysql
87
 
    juju add-relation quantum-gateway-extnet2 rabbitmq-server
88
 
    juju add-relation quantum-gateway-extnet2 nova-cloud-controller
 
77
    juju deploy neutron-gateway neutron-gateway-extnet1
 
78
    juju add-relation neutron-gateway-extnet1 mysql
 
79
    juju add-relation neutron-gateway-extnet1 rabbitmq-server
 
80
    juju add-relation neutron-gateway-extnet1 nova-cloud-controller
 
81
    juju deploy neutron-gateway neutron-gateway-extnet2
 
82
    juju add-relation neutron-gateway-extnet2 mysql
 
83
    juju add-relation neutron-gateway-extnet2 rabbitmq-server
 
84
    juju add-relation neutron-gateway-extnet2 nova-cloud-controller
89
85
 
90
86
    Create extnet1 and extnet2 via neutron client and take a note of their ids
91
87
 
92
 
    juju set quantum-gateway-extnet1 "run-internal-router=leader"
93
 
    juju set quantum-gateway-extnet2 "run-internal-router=none"
94
 
    juju set quantum-gateway-extnet1 "external-network-id=<extnet1 id>"
95
 
    juju set quantum-gateway-extnet2 "external-network-id=<extnet2 id>"
 
88
    juju set neutron-gateway-extnet1 "run-internal-router=leader"
 
89
    juju set neutron-gateway-extnet2 "run-internal-router=none"
 
90
    juju set neutron-gateway-extnet1 "external-network-id=<extnet1 id>"
 
91
    juju set neutron-gateway-extnet2 "external-network-id=<extnet2 id>"
96
92
 
97
93
Instance MTU
98
94
============
102
98
physical hosts and network equipment. When this is not possible or practical the
103
99
charm's instance-mtu option can be used to reduce instance MTU via DHCP.
104
100
 
105
 
    juju set quantum-gateway instance-mtu=1400
 
101
    juju set neutron-gateway instance-mtu=1400
106
102
 
107
103
OpenStack upstream documentation recomments a MTU value of 1400:
108
104
[Openstack documentation](http://docs.openstack.org/admin-guide-cloud/content/openvswitch_plugin.html)
202
198
    - {name: neutron,
203
199
       repository: 'git://github.com/openstack/neutron',
204
200
       branch: master}
205
 
 
206
 
TODO
207
 
----
208
 
 
209
 
 * Provide more network configuration use cases.
210
 
 * Support VLAN in addition to GRE+OpenFlow for L2 separation.