openstack-manuals/doc/install-guide/section_basics-networking.xml
Matt Kassawara 03cff88d61 Updated networking content
I updated the networking content as follows:

1) Reordered example architectures to place the 3-node neutron
   architecture before the 2-node nova-network architecture which
   agrees with the order presented in other portions of the
   installation guide.
2) Changed network service naming to agree with conventions.
3) Permanently unlinked the Open vSwitch (OVS) plug-in sections from
   the Networking chapter. However, I will refrain from deleting
   the associated files in case we need to restore them.
4) Temporarily unlinked the Open vSwitch (OVS) portion of the Neutron
   concepts section until we can update it to reflect the Modular
   Layer 2 (ML2) plug-in.
5) Addressed other minor issues.

Change-Id: I7c285fcabaab65237477e8241f406dac28190344
Closes-Bug: #1309636
2014-04-18 17:07:39 -06:00

82 lines
4.1 KiB
XML

<section 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="basics-networking">
<?dbhtml-stop-chunking?>
<title>Networking</title>
<para>After installing the operating system on each node for the
architecture that you choose to deploy, you must configure the network
interfaces. We recommend that you disable any automated network
management tools and manually edit the appropriate configuration files
for your distribution. For more information on how to configure networking
on your distribution, see the
<link os="ubuntu"
xlink:href="https://help.ubuntu.com/lts/serverguide/network-configuration.html"
>documentation.</link>
<link os="debian"
xlink:href="https://wiki.debian.org/NetworkConfiguration"
>documentation.</link>
<link os="rhel;centos;fedora"
xlink:href="https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s1-networkscripts-interfaces.html"
>documentation.</link>
<link os="sles;opensuse"
xlink:href="https://www.suse.com/documentation/sles11/book_sle_admin/data/sec_basicnet_manconf.html"
>SLES 11</link>
<phrase os="sles;opensuse"> or </phrase>
<link os="sles;opensuse"
xlink:href="http://activedoc.opensuse.org/book/opensuse-reference/chapter-13-basic-networking"
>openSUSE documentation.</link></para>
<procedure os="fedora">
<title>To disable <systemitem class="service">NetworkManager</systemitem>
and enable the <systemitem class="service">network</systemitem>
service:</title>
<step>
<screen><prompt>#</prompt> <userinput>service NetworkManager stop</userinput>
<prompt>#</prompt> <userinput>service network start</userinput>
<prompt>#</prompt> <userinput>chkconfig NetworkManager off</userinput>
<prompt>#</prompt> <userinput>chkconfig network on</userinput></screen>
</step>
</procedure>
<procedure os="sles;opensuse">
<title>To disable <systemitem class="service">NetworkManager</systemitem>:</title>
<step>
<para>Use the YaST network module:</para>
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>yast2 network</userinput></screen>
<para>For more information, see the
<link xlink:href="https://www.suse.com/documentation/sles11/book_sle_admin/data/sec_nm_activate.html">SLES </link> or
the
<link xlink:href="http://activedoc.opensuse.org/book/opensuse-reference/chapter-13-basic-networking#sec.basicnet.yast.netcard.global">
openSUSE documentation</link>.
</para>
</step>
</procedure>
<para os="rhel;centos">RHEL and derivatives including CentOS and Scientific
Linux enable a restrictive <glossterm>firewall</glossterm> by default.
During this installation, certain steps will fail unless you alter or
disable the firewall. For further information about securing your
installation, refer to the
<link xlink:href="http://docs.openstack.org/sec/">
OpenStack Security Guide</link>.</para>
<para os="fedora">On Fedora, <literal>firewalld</literal> replaces
<literal>iptables</literal> as the default firewall system. While you
can use <literal>firewalld</literal> successfully, this guide
references <literal>iptables</literal> for compatibility with other
distributions.</para>
<procedure os="fedora">
<title>To disable <literal>firewalld</literal> and enable
<literal>iptables</literal>:</title>
<step>
<screen><prompt>#</prompt> <userinput>service firewalld stop</userinput>
<prompt>#</prompt> <userinput>service iptables start</userinput>
<prompt>#</prompt> <userinput>chkconfig firewalld off</userinput>
<prompt>#</prompt> <userinput>chkconfig iptables on</userinput></screen>
</step>
</procedure>
<para>Proceed to network configuration for the example
<link linkend="basics-networking-neutron">OpenStack Networking (neutron)
</link> or <link linkend="basics-networking-nova">legacy
networking (nova-network)</link> architecture.</para>
<xi:include href="section_basics-networking-neutron.xml"/>
<xi:include href="section_basics-networking-nova.xml"/>
</section>