17fc8c8a8b
As part of the installation guide improvement project, I performed the following operations on the Networking chapter: 1) Moved Neutron ML2 sections before OVS sections and updated associated notes to steer users toward ML2. 2) Removed database population steps because Neutron populates the database at first run. 3) Moved 'enable_security_group' key to [securitygroup] section. 4) Removed extraneous colons from procedure titles. 5) Added command output to Neutron initial networks section. 6) Added command output to Nova initial networks section. Change-Id: Ie677d199d2c64ef2a564eaa551295e1a321db02c Partial-Bug: #1291071 Implements: blueprint networking-install-guide-improvements
73 lines
3.3 KiB
XML
73 lines
3.3 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<chapter xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="ch_networking">
|
|
<title>Add a networking service</title>
|
|
<!-- FIXME Temporarily replacing this warning.
|
|
<warning>
|
|
<para>This chapter is a bit more adventurous than we would
|
|
like. We are working on cleanup and improvements to it.
|
|
Like for the rest of the Installation Guide, feedback
|
|
through bug reports and patches to improve it are
|
|
welcome.</para>
|
|
</warning>
|
|
-->
|
|
<warning>
|
|
<para>We are updating this material for Icehouse. You may find
|
|
structure and/or content issues during this process.</para>
|
|
</warning>
|
|
<para>Configuring networking in OpenStack can be a bewildering
|
|
experience. This guide provides step-by-step instructions for both
|
|
OpenStack Networking (neutron) and the legacy networking (nova-network)
|
|
service. If you are unsure which to use, we recommend trying
|
|
OpenStack Networking because it offers a considerable number of
|
|
features and flexibility including <glossterm baseform="plug-in"
|
|
>plug-ins</glossterm> for a variety of emerging products
|
|
supporting <glossterm>virtual networking</glossterm>. See the
|
|
<link
|
|
xlink:href="http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html"
|
|
>Networking</link> chapter of the <citetitle>OpenStack Cloud
|
|
Administrator Guide</citetitle> for more information.</para>
|
|
<section xml:id="section_neutron-networking">
|
|
<title>Networking (neutron)</title>
|
|
<xi:include href="section_neutron-concepts.xml"/>
|
|
<section xml:id="section_neutron-networking-ml2">
|
|
<title>Modular Layer 2 (ML2) plug-in</title>
|
|
<note>
|
|
<para>We primarily tested the Modular Layer 2 (ML2) plug-in on
|
|
Icehouse and suggest that you implement it instead of the
|
|
traditional Open vSwitch (OVS) plug-in.</para>
|
|
</note>
|
|
<xi:include href="section_neutron-ml2-controller-node.xml"/>
|
|
<xi:include href="section_neutron-ml2-network-node.xml"/>
|
|
<xi:include href="section_neutron-ml2-compute-node.xml"/>
|
|
</section>
|
|
<section xml:id="section_neutron-networking-ovs">
|
|
<title>Open vSwitch (OVS) plug-in</title>
|
|
<warning>
|
|
<para>We suggest that you implement the Modular Layer 2 (ML2) plug-in
|
|
on Icehouse until we completely test the traditional Open vSwitch
|
|
(OVS) plug-in.</para>
|
|
</warning>
|
|
<xi:include href="section_neutron-ovs-controller-node.xml"/>
|
|
<xi:include href="section_neutron-ovs-network-node.xml"/>
|
|
<xi:include href="section_neutron-ovs-compute-node.xml"/>
|
|
</section>
|
|
<xi:include href="section_neutron-initial-networks.xml"/>
|
|
</section>
|
|
<section xml:id="section_nova-networking">
|
|
<title>Legacy networking</title>
|
|
<xi:include href="section_nova-networking-compute-node.xml"/>
|
|
<xi:include href="section_nova-networking-initial-network.xml"/>
|
|
</section>
|
|
<section xml:id="section_networking_next_steps">
|
|
<title>Next steps</title>
|
|
<para>
|
|
Your OpenStack environment now includes the core components necessary
|
|
to launch a basic instance. You can
|
|
<link linkend="launch-instance">launch an instance</link> or add more
|
|
services to your environment in the following chapters.</para>
|
|
</section>
|
|
</chapter>
|