openstack-manuals/doc/install-guide/basic-install_network-common.xml
Tom Fifield 8f7d1bd81a Starts install guide chapter for neutron, cleanups
This begins the install guide chapter for neutron,
and cleans up some sections from the guide that will
not be used even as references.

* hypervisor_selection - not relevant for the adventure
where the choice is done prior, and makes some difficult
value judgement statemtnts

* scripted ubuntu install - not the purpose of this guide
and old content that isn't helpful for the rewrite

* image-troubleshooting - empty section, belongs in
cloud-admin-guide anyway

* vnc-console - already in image_install

* identity_config_keystone - already better done in
individual sections

* install nova-volume - very dated content, already
in cinder install

* basic install files - no longer needed for reference

Change-Id: I1979eeba091c7118db7cc30ad7c66f30345fe49d
2013-10-15 15:22:51 +11:00

211 lines
8.8 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<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="basic-network-common">
<title>Common services</title>
<section xml:id="network-os">
<title>Operating System</title>
<orderedlist>
<listitem>
<para>Install <phrase os="rhel;centos;fedora">Fedora 18</phrase>
<phrase os="ubuntu;debian">Ubuntu 12.04 or Debian Wheezy</phrase> <phrase
os="opensuse">openSUSE 12.3</phrase>.
The exact installation procedure is outside the scope of this document, but please note the following configurations:<itemizedlist>
<listitem>
<para>Time zone: <emphasis role="bold">UTC</emphasis></para>
</listitem>
<listitem>
<para>Hostname: <emphasis role="bold">network</emphasis></para>
</listitem>
<listitem>
<para>Packages: <emphasis role="bold">OpenSSH-Server</emphasis></para>
</listitem>
</itemizedlist></para>
<para>Once installation has finished, the server reboots.</para>
</listitem>
<listitem>
<para>Setup the repositories as described in
<xref linkend="basic-install_common_repo" />.
</para>
</listitem>
<listitem>
<para>Configure the network:</para>
<para os="ubuntu;debian">
<itemizedlist>
<listitem>
<para>Edit <filename>/etc/network/interfaces</filename>:
<note>
<para>When you configure Open vSwitch, you must change the contents of this file.</para>
</note>
<programlisting># Internal Network
auto eth0
iface eth0 inet static
address 10.10.10.9
netmask 255.255.255.0
# External Network
auto eth1
iface eth1 inet static
address 10.0.0.9
netmask 255.255.255.0
gateway 10.0.0.1
dns-nameservers 8.8.8.8</programlisting>
</para>
</listitem>
</itemizedlist>
</para>
<para os="ubuntu;debian">
<itemizedlist>
<listitem>
<para>Edit <filename>/etc/sysctl.conf</filename>:
<programlisting>net.ipv4.ip_forward = 1
net.ipv4.conf.all.forwarding = 1
net.ipv4.conf.all.rp_filter = 0
net.ipv4.conf.default.rp_filter = 0</programlisting>
Then, restart the network service:
<screen><prompt>#</prompt> <userinput>service networking restart</userinput></screen>
And apply the sysctl settings:
<screen><prompt>#</prompt> <userinput>sysctl -e -p /etc/sysctl.conf</userinput></screen>
</para>
</listitem>
</itemizedlist>
</para>
<para os="rhel;centos;fedora">
<itemizedlist>
<listitem>
<para>Set up old ethernet nic device names:</para>
<para>
<screen><prompt>#</prompt> <userinput>sed -i 's/# GOTO="netdevicename_end"/GOTO="netdevicename_end"/g'/lib/udev/rules.d/71-biosdevname.rules</userinput></screen>
</para>
</listitem>
<listitem>
<para>Edit <filename>/etc/sysconf/network-scripts/ifcfg-eth0</filename>:
<programlisting># Internal Network
DEVICE=eth0
TYPE=Ethernet
BOOTPROTO=static
IPADDR=10.10.10.9
NETMASK=255.255.255.0
GATEWAY=192.168.0.254
DNS1=8.8.8.8
DEFROUTE=yes
ONBOOT=yes</programlisting>
</para>
</listitem>
<listitem>
<para>Edit <filename>/etc/sysconf/network-scripts/ifcfg-eth1</filename>:
<programlisting># External
DEVICE=eth1
TYPE=Ethernet
BOOTPROTO=static
IPADDR=10.10.10.1
NETMASK=255.255.255.0
DEFROUTE=yes
ONBOOT=yes</programlisting>
</para>
</listitem>
<listitem>
<para>Edit <filename>/etc/sysconf/network-scripts/ifcfg-eth2</filename>:
<programlisting>#Public Bridge
DEVICE=eth2
TYPE=Ethernet
BOOTPROTO=static
IPADDR=10.10.10.1
NETMASK=255.255.255.0
DEFROUTE=yes
ONBOOT=yes</programlisting>
</para>
</listitem>
<listitem>
<para>
Reboot.
</para>
</listitem>
</itemizedlist>
</para>
<para os="opensuse">
To set up the two network interfaces, start the YaST
network module, as follows:
<screen><prompt>#</prompt> <userinput>yast2 network</userinput></screen>
<itemizedlist>
<listitem>
<para>
Use the following parameters to set up the first ethernet card
<emphasis role="bold">eth0</emphasis> for the internal network:
<programlisting>
Statically assigned IP Address
IP Address: 10.10.10.9
Subnet Mask: 255.255.255.0
</programlisting>
</para>
</listitem>
<listitem>
<para>
Use the following parameters to set up the second ethernet card
<emphasis role="bold">eth1</emphasis> for the external network:
<programlisting>
Statically assigned IP Address
IP Address: 10.0.0.9
Subnet Mask: 255.255.255.0
</programlisting>
</para>
</listitem>
<listitem>
<para>
Use the following parameters to set up <emphasis role="bold">Routing</emphasis>:
<programlisting>
Default IPv4 Gateway: 10.0.0.1
Device: eth1
</programlisting>
</para>
</listitem>
<listitem>
<para>
Use the following parameters to set up <emphasis role="bold">Hostname/DNS</emphasis>:
<programlisting>
Hostname: network
Name Server 1: 8.8.8.8
</programlisting>
</para>
</listitem>
<listitem>
<para>
Save the configuration and leave YaST.
</para>
</listitem>
</itemizedlist>
</para>
<para>
<itemizedlist>
<listitem>
<para>Edit the <filename>/etc/hosts</filename> file and add
<emphasis role="bold">cloud</emphasis>,
<emphasis role="bold">network</emphasis> and
<emphasis role="bold">c01</emphasis> hostnames with correct IP.
<programlisting>127.0.0.1 localhost
10.10.10.10 cloud
10.10.10.9 network
10.10.10.11 c01</programlisting>
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>Install NTP:<itemizedlist>
<listitem>
<para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ntp</userinput></screen>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install ntp</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install ntp</userinput></screen>
</para>
</listitem>
</itemizedlist></para>
</listitem>
</orderedlist>
</section>
</section>