20f995710f
As suggested by Diane in https://review.openstack.org/#/c/55950/1/doc/install-guide/section_nova-network.xml Change-Id: Id5dd614d638fd9bd1bb620423842f4f15fe0b5d5 backport: havana
107 lines
6.2 KiB
XML
107 lines
6.2 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="nova-network">
|
|
<title>Enable networking</title>
|
|
<para>Configuring networking can be a bewildering experience. The
|
|
following example shows the simplest production-ready
|
|
configuration that is available: the legacy networking in
|
|
OpenStack Compute, with a flat network, that takes care of
|
|
DHCP.</para>
|
|
<para>This set up uses multi-host functionality. Networking is
|
|
configured to be highly available by distributing networking
|
|
functionality across multiple hosts. As a result, no single
|
|
network controller acts as a single point of failure. This
|
|
process configures each compute node for networking. You must
|
|
complete some minimal configuration on the controller.</para>
|
|
<note>
|
|
<para>If you need the full software-defined networking stack, see
|
|
<xref linkend="ch_neutron"/>.</para>
|
|
</note>
|
|
<procedure>
|
|
<step>
|
|
<para>Install the appropriate packages for compute
|
|
networking:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-network</userinput></screen>
|
|
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-network</userinput></screen>
|
|
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-network</userinput></screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Edit the <filename>nova.conf</filename> file to define the
|
|
networking mode:</para>
|
|
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
|
network_manager nova.network.manager.FlatDHCPManager</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
|
firewall_driver nova.virt.libvirt.firewall.IptablesFirewallDriver</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_size 254</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT allow_same_net_traffic False</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT multi_host True</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT send_arp_for_ha True</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT share_dhcp_address True</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT force_dhcp_release True</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT flat_interface eth1</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT flat_network_bridge br100</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT public_interface eth1</userinput></screen>
|
|
<screen os="opensuse;sles">
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_api_class nova.network.api.API</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT security_group_api nova</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT rabbit_host <replaceable>controller</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf database connection mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@<replaceable>controller</replaceable>/nova</userinput></screen>
|
|
|
|
<para os="ubuntu;debian">Edit the
|
|
<filename>/etc/nova/nova.conf</filename> file and add these
|
|
lines to the <literal>[DEFAULT]</literal> section:</para>
|
|
<programlisting os="ubuntu;debian" language="ini">[DEFAULT]
|
|
...
|
|
|
|
network_manager=nova.network.manager.FlatDHCPManager
|
|
firewall_driver=nova.virt.libvirt.firewall.IptablesFirewallDriver
|
|
network_size=254
|
|
allow_same_net_traffic=False
|
|
multi_host=True
|
|
send_arp_for_ha=True
|
|
share_dhcp_address=True
|
|
force_dhcp_release=True
|
|
flat_network_bridge=br100
|
|
flat_interface=eth1
|
|
public_interface=eth1
|
|
rabbit_host=<replaceable>controller</replaceable></programlisting>
|
|
</step>
|
|
<step os="ubuntu;debian">
|
|
<para>In the multi-host scenario, you also need to configure the database
|
|
access. Edit <filename>/etc/nova/nova.conf</filename> and set the
|
|
<code>connection</code> variable in the <literal>[database]</literal>
|
|
section.</para>
|
|
<programlisting language="ini">[database]
|
|
connection = mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@<replaceable>controller</replaceable>/nova</programlisting>
|
|
</step>
|
|
<step os="fedora;rhel;centos">
|
|
<para>Provide a local metadata service that is reachable from
|
|
instances on this compute node. Perform this step only on
|
|
compute nodes that do not run the <systemitem class="service"
|
|
>nova-api</systemitem> service.</para>
|
|
<screen><prompt>#</prompt> <userinput>yum install openstack-nova-api</userinput>
|
|
<prompt>#</prompt> <userinput>service openstack-nova-metadata-api start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-metadata-api on</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para os="ubuntu;debian">Restart the network service:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-network restart</userinput></screen>
|
|
|
|
<para os="fedora;rhel;centos;opensuse;sles">Start the network
|
|
service and configure it to start when the system
|
|
boots:</para>
|
|
<screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-network restart</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-network on</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
|
|
<para>Create a network that virtual machines can use. Do this once
|
|
for the entire installation and not on each compute node. Run the
|
|
<command>nova network-create</command> command on the controller:</para>
|
|
<screen><prompt>#</prompt> <userinput>source keystonerc</userinput></screen>
|
|
<screen><prompt>#</prompt> <userinput>nova network-create vmnet --fixed-range-v4=10.0.0.0/24 \
|
|
--bridge-interface=br100 --multi-host=T</userinput></screen>
|
|
</section>
|