openstack-manuals/doc/install-guide/basic-install-files/basic-install_compute-neutron.xml
Diane Fleming 64b6c9261e Folder rename, file rename, flattening of directories
Current folder name	New folder name	        Book title
----------------------------------------------------------
basic-install 	        DELETE
cli-guide	        DELETE
common	                common
NEW	                admin-guide-cloud	Cloud Administrators Guide
docbkx-example	        DELETE
openstack-block-storage-admin 	DELETE
openstack-compute-admin 	DELETE
openstack-config 	config-reference	OpenStack Configuration Reference
openstack-ha 	        high-availability-guide	OpenStack High Availabilty Guide
openstack-image	        image-guide	OpenStack Virtual Machine Image Guide
openstack-install 	install-guide	OpenStack Installation Guide
openstack-network-connectivity-admin 	admin-guide-network 	OpenStack Networking Administration Guide
openstack-object-storage-admin 	DELETE
openstack-security 	security-guide	OpenStack Security Guide
openstack-training 	training-guide	OpenStack Training Guide
openstack-user 	        user-guide	OpenStack End User Guide
openstack-user-admin 	user-guide-admin	OpenStack Admin User Guide
glossary	        NEW        	OpenStack Glossary

bug: #1220407

Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7
author: diane fleming
2013-09-08 15:15:50 -07:00

100 lines
6.0 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-install_compute-neutron">
<title>OpenStack Networking (Compute Node)</title>
<section xml:id="compute-ovs">
<title>Open vSwitch</title>
<para>
<orderedlist>
<listitem>
<para>Install the packages:
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install openvswitch-switch</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openvswitch-switch</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openvswitch-switch</userinput></screen>
</para>
</listitem>
<listitem>
<para>Start Open vSwitch service
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service openvswitch-switch start</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>service openvswitch-switch start</userinput>
<prompt>#</prompt> <userinput>chkconfig openvswitch-switch on</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start openvswitch-switch</userinput>
<prompt>#</prompt> <userinput>systemctl enable openvswitch-switch</userinput></screen>
</para>
</listitem>
<listitem>
<para>Create an internal bridge. Just as described in the Introduction to this guide, the Compute Node
does not provide an external bridge. This enforces all instances' network traffic to go through
the Network Controller. This is known as a "single-node" networking setup.
<screen><prompt>#</prompt> <userinput>ovs-vsctl add-br br-int</userinput></screen>
</para>
</listitem>
</orderedlist>
</para>
</section>
<section xml:id="compute-neutron">
<title>OpenStack Networking</title>
<para>
<orderedlist>
<listitem>
<para>Install the packages:
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-openvswitch-agent</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-neutron-openvswitch</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-neutron-openvswitch-agent</userinput></screen>
</para>
</listitem>
<listitem>
<para>Edit <filename>/etc/neutron/neutron.conf</filename>:
<programlisting os="ubuntu;debian" language="ini">[DEFAULT]
rabbit_host = 10.10.10.10
rabbit_password = password
verbose = True</programlisting>
<programlisting os="centos;rhel;fedora" language="ini">verbose = True
rpc_backend=neutron.openstack.common.rpc.impl_qpid</programlisting>
<programlisting os="opensuse" language="ini">[DEFAULT]
rabbit_host = 10.10.10.10
rabbit_password = password
verbose = True</programlisting>
</para>
</listitem>
<listitem>
<para>Edit <filename>/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini</filename>:
<programlisting language="ini">[database]
sql_connection = mysql://neutron:password@10.10.10.1/neutron
[ovs]
tenant_network_type = gre
tunnel_id_ranges = 1:1000
local_ip = 10.10.10.11
enable_tunneling = True
[securitygroup]
firewall_driver = \
neutron.agent.linux.iptables_firewall.OVSHybridIptablesFirewallDriver</programlisting>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>ln -s /etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini \
/etc/neutron/plugin.ini</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>ln -s /etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini \
/etc/neutron/plugin.ini</userinput></screen>
</para>
</listitem>
<listitem>
<para>Start the Agent:
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service neutron-plugin-openvswitch-agent restart</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>service neutron-openvswitch-agent restart</userinput>
<prompt>#</prompt> <userinput>chkconfig neutron-openvswitch-agent on</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-neutron-openvswitch-agent</userinput>
<prompt>#</prompt> <userinput>systemctl enable openstack-neutron-openvswitch-agent</userinput></screen>
</para>
</listitem>
<listitem os="centos;rhel;fedora">
<para>Ensure the cleanup utility is started on future boots:</para>
<screen><prompt>#</prompt> <userinput>chkconfig neutron-ovs-cleanup on</userinput></screen>
</listitem>
</orderedlist>
<note><para>Check the <filename>/var/log/neutron/openvswitch-agent.log</filename> file for errors that would
prevent the Networking service from successfully starting.</para></note>
</para>
</section>
</section>