Updates single flat use-case example for RHEL/CentOS/Fedora
Adds specific configuration options for RHEL, CentOS and Fedora based distributions which were missing - e.g. the guide presumed RabbitMQ was in use despite it not being relevant for these platforms. In addition it adds clarity on where to find further information or how to complete a specific step where necessary, something the existing implementation lacked. Now uses openstack-config in RHEL and SUSE based platforms. Change-Id: I6c9a45114afbfa99ea2d01a3f682a0dc78a72530 backport: havana Closes-Bug: 1266418
This commit is contained in:
Rhys Oxenham
@@ -50,7 +50,9 @@
|
||||
controller node.</para>
|
||||
<note>
|
||||
<para>The <systemitem class="service">nova-network</systemitem> service
|
||||
should not be running. This is replaced by Networking. To delete a network, use <code>nova-manage network delete</code>:</para>
|
||||
should not be running. This is replaced by the OpenStack Networking component,
|
||||
<systemitem class="service">neutron</systemitem>.
|
||||
To delete a network, run this command:</para>
|
||||
<screen><prompt>#</prompt> <userinput>nova-manage network delete --help</userinput>
|
||||
<computeroutput> Usage: nova-manage network delete <args> [options]
|
||||
|
||||
@@ -118,9 +120,13 @@
|
||||
<listitem>
|
||||
<para>Additional services:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>RabbitMQ is running with default guest and
|
||||
its password.</para>
|
||||
<listitem os="ubuntu;debian;opensuse;sles">
|
||||
<para>RabbitMQ is running with the default guest user
|
||||
and password.</para>
|
||||
</listitem>
|
||||
<listitem os="rhel;centos;fedora">
|
||||
<para>Qpid is running with the default guest user
|
||||
and password.</para>
|
||||
</listitem>
|
||||
<listitem os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
||||
<para>MySQL server (user is <emphasis role="bold"
|
||||
@@ -153,16 +159,66 @@
|
||||
configure the database, the
|
||||
<code>keystone_authtoken</code>,
|
||||
and the RabbitMQ credentials.</para>
|
||||
<para>
|
||||
See <xref linkend="install-neutron.dedicated-controller-node"/>
|
||||
for installation instructions.</para>
|
||||
</listitem>
|
||||
<listitem
|
||||
os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
||||
<para>Create database <emphasis
|
||||
role="bold"
|
||||
>ovs_neutron</emphasis>.</para>
|
||||
<para>
|
||||
See <xref linkend="neutron-install-network-node"/>
|
||||
for database creation details.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem
|
||||
os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
||||
<para>Update the Networking <filename>
|
||||
<listitem os="rhel;centos;fedora;opensuse;sles">
|
||||
<para>If not already configured, update the Networking <filename>
|
||||
/etc/neutron/neutron.conf</filename>
|
||||
configuration file to use the Identity Service, the plug-in,
|
||||
and database configuration:</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf keystone_authtoken \
|
||||
auth_port 35357</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf keystone_authtoken \
|
||||
auth_protocol http</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf keystone_authtoken \
|
||||
admin_tenant_name service</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf keystone_authtoken \
|
||||
admin_user neutron</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf keystone_authtoken \
|
||||
admin_password <replaceable>NEUTRON_PASS</replaceable></userinput></screen>
|
||||
<para>Configure Networking to connect to the database:</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DATABASE sql_connection \
|
||||
mysql://neutron:<replaceable>NEUTRON_DBPASS</replaceable>@controller/neutron</userinput></screen>
|
||||
<para>Configure Networking to use your chosen plug-in:</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
core_plugin neutron.plugins.openvswitch.ovs_neutron_plugin.OVSNeutronPluginV2</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
control_exchange neutron</userinput></screen>
|
||||
<para os="opensuse;sles">Configure access to the <application>RabbitMQ</application> service:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rpc_backend neutron.openstack.common.rpc.impl_kombu</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_host controller</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_userid guest</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_password <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
||||
<para os="rhel;centos;fedora">Configure access to the <application>Qpid</application> message queue:</para>
|
||||
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rpc_backend neutron.openstack.common.rpc.impl_qpid</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_hostname <replaceable>controller</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_port 5672</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_username <replaceable>guest</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_password <replaceable>guest</replaceable></userinput></screen>
|
||||
</listitem>
|
||||
<listitem os="ubuntu">
|
||||
<para>If not already configured, update the Networking <filename>
|
||||
/etc/neutron/neutron.conf</filename>
|
||||
configuration file to choose a plug-in
|
||||
and Identity Service user as
|
||||
@@ -186,14 +242,22 @@ admin_password=<replaceable>NEUTRON_PASS</replaceable>
|
||||
<listitem>
|
||||
<para>Update the plug-in <filename>
|
||||
/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini</filename>
|
||||
configuration file:</para>
|
||||
<programlisting language="ini">[ovs]
|
||||
configuration file with the bridge mappings:</para>
|
||||
<programlisting language="ini" os="ubuntu;debian">[ovs]
|
||||
network_vlan_ranges = physnet1
|
||||
bridge_mappings = physnet1:br-eth0
|
||||
</programlisting>
|
||||
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set \
|
||||
/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini OVS \
|
||||
network_vlan_ranges physnet1</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set \
|
||||
/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini OVS \
|
||||
bridge_mappings physnet1:br-eth0</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Start the Networking service</para>
|
||||
<para>Restart the Networking service:</para>
|
||||
<screen os="rhel;centos;fedora;ubuntu;debian"><prompt>#</prompt> <userinput>service neutron-server restart</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service openstack-neutron restart</userinput></screen>
|
||||
</listitem>
|
||||
</orderedlist></para>
|
||||
</listitem>
|
||||
@@ -204,14 +268,16 @@ bridge_mappings = physnet1:br-eth0
|
||||
class="service"
|
||||
>nova-compute</systemitem>
|
||||
service.</para>
|
||||
<para>
|
||||
See <xref linkend="nova-compute"/>
|
||||
for installation instructions.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update the Compute <filename>
|
||||
/etc/nova/nova.conf</filename>
|
||||
configuration file. Make sure the
|
||||
following line is at the end of the
|
||||
file:</para>
|
||||
<programlisting language="ini">network_api_class=nova.network.neutronv2.api.API
|
||||
configuration file to make use
|
||||
of OpenStack Networking:</para>
|
||||
<programlisting language="ini" os="ubuntu;debian">network_api_class=nova.network.neutronv2.api.API
|
||||
|
||||
neutron_admin_username=neutron
|
||||
neutron_admin_password=<replaceable>NEUTRON_PASS</replaceable>
|
||||
@@ -219,29 +285,44 @@ neutron_admin_auth_url=http://<replaceable>controller</replaceable>:35357/v2.0/
|
||||
neutron_auth_strategy=keystone
|
||||
neutron_admin_tenant_name=service
|
||||
neutron_url=http://<replaceable>controller</replaceable>:9696/</programlisting>
|
||||
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
network_api_class nova.network.neutronv2.api.API</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
neutron_url http://<replaceable>controller</replaceable>:9696</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
neutron_auth_strategy keystone</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
neutron_admin_tenant_name service</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
neutron_admin_username neutron</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
neutron_admin_password <replaceable>NEUTRON_PASS</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
|
||||
neutron_admin_auth_url http://<replaceable>controller</replaceable>:35357/v2.0</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Restart the Compute services</para>
|
||||
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-compute restart</userinput></screen>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-compute restart</userinput></screen>
|
||||
</listitem>
|
||||
</orderedlist></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><emphasis role="bold">Compute and Network
|
||||
nodeL2 agent</emphasis><orderedlist>
|
||||
node - L2 agent</emphasis><orderedlist>
|
||||
<listitem>
|
||||
<para>Install and start Open
|
||||
vSwitch.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Install the L2 agent (Neutron Open
|
||||
vSwitch agent).</para>
|
||||
<para>Install and start Open vSwitch.
|
||||
Then, configure <systemitem class="service">neutron</systemitem> accordingly.</para>
|
||||
<para>
|
||||
See <xref linkend="install-neutron.install-plug-in"/>
|
||||
for detailed instructions.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Add the integration bridge to Open
|
||||
vSwitch:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ovs-vsctl add-br br-int</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<listitem os="ubuntu;debian">
|
||||
<para>Update the Networking <filename>
|
||||
/etc/neutron/neutron.conf</filename>
|
||||
configuration file:</para>
|
||||
@@ -255,20 +336,59 @@ notification_driver = neutron.openstack.common.notifier.rabbit_notifier
|
||||
[database]
|
||||
connection = mysql://neutron:<replaceable>NEUTRON_DBPASS</replaceable>@<replaceable>controller</replaceable>/neutron
|
||||
</programlisting>
|
||||
</listitem>
|
||||
<listitem os="rhel;centos;fedora;opensuse;sles">
|
||||
<para>If not already configured, update the Networking <filename>
|
||||
/etc/neutron/neutron.conf</filename>
|
||||
configuration file to use the plug-in, message queue,
|
||||
and database configuration:</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DATABASE sql_connection \
|
||||
mysql://neutron:<replaceable>NEUTRON_DBPASS</replaceable>@controller/neutron</userinput></screen>
|
||||
<para>Configure Networking to use your chosen plug-in:</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
core_plugin neutron.plugins.openvswitch.ovs_neutron_plugin.OVSNeutronPluginV2</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
control_exchange neutron</userinput></screen>
|
||||
<para os="opensuse;sles">Configure access to the <application>RabbitMQ</application> service:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rpc_backend neutron.openstack.common.rpc.impl_kombu</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_host controller</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_userid guest</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_password <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
||||
<para os="rhel;centos;fedora">Configure access to the <application>Qpid</application> message queue:</para>
|
||||
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rpc_backend neutron.openstack.common.rpc.impl_qpid</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_hostname <replaceable>controller</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_port 5672</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_username <replaceable>guest</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_password <replaceable>guest</replaceable></userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update the plug-in <filename>
|
||||
/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini</filename>
|
||||
configuration file:</para>
|
||||
<programlisting language="ini">[ovs]
|
||||
<programlisting language="ini" os="ubuntu;debian">[ovs]
|
||||
network_vlan_ranges = physnet1
|
||||
bridge_mappings = physnet1:br-eth0</programlisting>
|
||||
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set \
|
||||
/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini OVS \
|
||||
network_vlan_ranges physnet1</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set \
|
||||
/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini OVS \
|
||||
bridge_mappings physnet1:br-eth0</userinput></screen>
|
||||
</listitem>
|
||||
<listitem os="centos">
|
||||
<listitem os="centos">
|
||||
<para>Create a symbolic link from <filename>/etc/neutron/plugin.ini</filename> to <filename>/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini</filename> or <code>neutron-server</code> will not run:
|
||||
</para>
|
||||
<screen><prompt>#</prompt> <userinput>ln -s /etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini /etc/neutron/plugin.ini</userinput></screen>
|
||||
</listitem>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Create the <emphasis role="bold"
|
||||
>br-eth0</emphasis> network bridge
|
||||
@@ -278,18 +398,23 @@ bridge_mappings = physnet1:br-eth0</programlisting>
|
||||
<prompt>#</prompt> <userinput>ovs-vsctl add-port br-eth0 eth0</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Start the OpenStack Networking L2
|
||||
agent.</para>
|
||||
<para>Restart the OpenStack Networking L2
|
||||
agent:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service openstack-neutron-openvswitch-agent restart</userinput></screen>
|
||||
<screen os="rhel;centos;fedora;ubuntu;debian"><prompt>#</prompt> <userinput>service neutron-openvswitch-agent restart</userinput></screen>
|
||||
</listitem>
|
||||
</orderedlist></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><emphasis role="bold">Network nodeDHCP
|
||||
<para><emphasis role="bold">Network node - DHCP
|
||||
agent</emphasis><orderedlist>
|
||||
<listitem>
|
||||
<para>Install the DHCP agent.</para>
|
||||
<para>
|
||||
See <xref linkend="install-neutron.dedicated-controller-node"/>
|
||||
for <emphasis role="bold">generic</emphasis> installation instructions.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<listitem os="ubuntu;debian">
|
||||
<para>Update the Networking <filename>
|
||||
/etc/neutron/neutron.conf</filename>
|
||||
configuration file:</para>
|
||||
@@ -300,14 +425,47 @@ rabbit_host = <replaceable>controller</replaceable>
|
||||
rabbit_password = <replaceable>RABBIT_PASS</replaceable>
|
||||
notification_driver = neutron.openstack.common.notifier.rabbit_notifier</programlisting>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Update the DHCP <filename>
|
||||
/etc/neutron/dhcp_agent.ini</filename>
|
||||
configuration file:</para>
|
||||
<programlisting language="ini">interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlisting>
|
||||
<listitem os="rhel;centos;fedora;opensuse;sles">
|
||||
<para>If not already configured, update the Networking <filename>
|
||||
/etc/neutron/neutron.conf</filename>
|
||||
configuration file to use the plug-in and message queue.</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
core_plugin neutron.plugins.openvswitch.ovs_neutron_plugin.OVSNeutronPluginV2</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
control_exchange neutron</userinput></screen>
|
||||
<para os="opensuse;sles">Configure access to the <application>RabbitMQ</application> service:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rpc_backend neutron.openstack.common.rpc.impl_kombu</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_host controller</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_userid guest</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rabbit_password <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
||||
<para os="rhel;centos;fedora">Configure access to the <application>Qpid</application> message queue:</para>
|
||||
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
rpc_backend neutron.openstack.common.rpc.impl_qpid</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_hostname <replaceable>controller</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_port 5672</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_username <replaceable>guest</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/neutron.conf DEFAULT \
|
||||
qpid_password <replaceable>guest</replaceable></userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Start the DHCP agent.</para>
|
||||
<para>Ensure that the DHCP agent is using the correct
|
||||
plug-in my changing the configuration in <filename>
|
||||
/etc/neutron/dhcp_agent.ini</filename>:</para>
|
||||
<programlisting language="ini" os="ubuntu;debian">interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlisting>
|
||||
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/neutron/dhcp_agent.ini DEFAULT \
|
||||
interface_driver neutron.agent.linux.interface.OVSInterfaceDriver</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Restart the DHCP agent:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service openstack-neutron-dhcp-agent restart</userinput></screen>
|
||||
<screen os="rhel;centos;fedora;ubuntu;debian"><prompt>#</prompt> <userinput>service neutron-dhcp-agent restart</userinput></screen>
|
||||
</listitem>
|
||||
</orderedlist></para>
|
||||
</listitem>
|
||||
|
||||
Reference in New Issue
Block a user