ab3b945c26
As part of the installation guide improvement project, I performed the following operations on the basic environment configuration chapter of the installation guide: 1) Split large ch_basics.xml file into smaller files to ease addition of new networking content and future updates. 2) Added information on how to install on VMs. 3) Added recommended minimum hardware requirements for each node. 4) Built detailed instructions for network configuration on three-node neutron and two-node nova example architectures including verification of connectivity using name resolution. 5) Clarified phrasing and wording. 6) Updated glossary as necessary. This patch primarily updates networking content in this chapter. Change-Id: Ib31a99448757d36ae29ff8069ddbeab8fe0106bd Partial-Bug: #1291071 Implements: blueprint networking-install-guide-improvements
81 lines
4.1 KiB
XML
81 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"
|
|
xlink:href="https://www.suse.com/documentation/sles11/book_sle_admin/data/sec_basicnet_manconf.html"
|
|
>documentation.</link>
|
|
<link os="opensuse"
|
|
xlink:href="http://activedoc.opensuse.org/book/opensuse-reference/chapter-13-basic-networking"
|
|
>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 os="sles">For more information, see the
|
|
<link xlink:href="https://www.suse.com/documentation/sles11/book_sle_admin/data/sec_nm_activate.html">documentation.</link></para>
|
|
<para os="opensuse">For more information, see the
|
|
<link xlink:href="http://activedoc.opensuse.org/book/opensuse-reference/chapter-13-basic-networking#sec.basicnet.yast.netcard.global">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
|
|
</link> or <link linkend="basics-networking-nova">legacy
|
|
networking</link> architecture.</para>
|
|
<xi:include href="section_basics-networking-neutron.xml"/>
|
|
<xi:include href="section_basics-networking-nova.xml"/>
|
|
</section>
|