openstack-manuals/doc/install-guide/basic-install_compute-neutron.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

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]
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>