fb88526110
Changed network interface configuration to use more generic naming which improves compatibility with more distributions. For example, RHEL 7 uses "ens#" rather than "eth#" for interface names. These changes also required updating various diagrams. This patch also removes redundant configuration instructions from the "Configure a compute node" section covered by architecture and basic environment configuration sections. Change-Id: Ia3c895d938c341398a9544f5eb10bb7346a29a06 Closes-Bug: #1312273
93 lines
5.2 KiB
XML
93 lines
5.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-networking-compute-node">
|
|
<title>Configure compute node</title>
|
|
<para>This section covers deployment of a simple
|
|
<glossterm>flat network</glossterm> that provides IP addresses to your
|
|
instances via <glossterm>DHCP</glossterm>. If your environment includes
|
|
multiple compute nodes, the <glossterm>multi-host</glossterm> feature
|
|
provides redundancy by spreading network functions across compute
|
|
nodes.</para>
|
|
<procedure>
|
|
<title>To install legacy networking components</title>
|
|
<step>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-network nova-api-metadata</userinput></screen>
|
|
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-network openstack-nova-api</userinput></screen>
|
|
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-network openstack-nova-api</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
<procedure>
|
|
<title>To configure legacy networking</title>
|
|
<step os="rhel;centos;fedora;sles;opensuse">
|
|
<para>Run the following commands:</para>
|
|
<para>Replace <replaceable>INTERFACE_NAME</replaceable> with the
|
|
actual interface name for the external network. For example,
|
|
<emphasis>eth1</emphasis> or <emphasis>ens224</emphasis>.</para>
|
|
<screen><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 \
|
|
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_network_bridge br100</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
|
flat_interface <replaceable>INTERFACE_NAME</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
|
public_interface <replaceable>INTERFACE_NAME</replaceable></userinput></screen>
|
|
</step>
|
|
<step os="ubuntu;debian">
|
|
<para>Edit the <filename>/etc/nova/nova.conf</filename> file and add the
|
|
following keys to the <literal>[DEFAULT]</literal> section:</para>
|
|
<para>Replace <replaceable>INTERFACE_NAME</replaceable> with the
|
|
actual interface name for the external network. For example,
|
|
<emphasis>eth1</emphasis> or <emphasis>ens224</emphasis>.</para>
|
|
<programlisting language="ini">[DEFAULT]
|
|
...
|
|
network_api_class = nova.network.api.API
|
|
security_group_api = nova
|
|
firewall_driver = nova.virt.libvirt.firewall.IptablesFirewallDriver
|
|
network_manager = nova.network.manager.FlatDHCPManager
|
|
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 = <replaceable>INTERFACE_NAME</replaceable>
|
|
public_interface = <replaceable>INTERFACE_NAME</replaceable></programlisting>
|
|
</step>
|
|
<step>
|
|
<para os="ubuntu;debian">Restart the services:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-network restart</userinput>
|
|
<prompt>#</prompt> <userinput>service nova-api-metadata restart</userinput></screen>
|
|
<para os="rhel;centos;fedora;sles;opensuse">Start the services and
|
|
configure them to start when the system boots:</para>
|
|
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>service openstack-nova-network start</userinput>
|
|
<prompt>#</prompt> <userinput>service openstack-nova-metadata-api start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-network on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-metadata-api on</userinput></screen>
|
|
<screen os="sles;opensuse"><prompt>#</prompt> <userinput>service openstack-nova-network start</userinput>
|
|
<prompt>#</prompt> <userinput>service openstack-nova-api-metadata start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-network on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-api-metadata on</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|