7d39198c1f
Bug 1247323 states a requirement to remove the instructions to copy .conf files between the controller and compute nodes. Bug 1245968 mentions this as a possible cause of the issue. This patch progresses both bugs, but resolves neither. Also fixes for some minor layout and wording issues. Change-Id: Ia92fbaf9152df561aa38dac4c91e9f38bd425964 backport: havana Partial-Bug: #1247323 Partial-Bug: #1245968
198 lines
10 KiB
XML
198 lines
10 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-compute">
|
|
<title>Configure a Compute node</title>
|
|
<para>After you configure the Compute service on the controller
|
|
node, you must configure another system as a Compute node. The
|
|
Compute node receives requests from the controller node and hosts
|
|
virtual machine instances. You can run all services on a single
|
|
node, but the examples in this guide use separate systems. This
|
|
makes it easy to scale horizontally by adding additional Compute
|
|
nodes following the instructions in this section.</para>
|
|
<para>The Compute service relies on a hypervisor to run virtual
|
|
machine instances. OpenStack can use various hypervisors, but this
|
|
guide uses KVM.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Configure the system. Use the instructions in <xref
|
|
linkend="ch_basics"/>, but note the following differences
|
|
from the controller node:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Use different IP addresses when you configure
|
|
<filename>eth0</filename>. This guide uses
|
|
<literal>192.168.0.11</literal> for the internal
|
|
network. Do not configure <literal>eth1</literal> with a
|
|
static IP address. The networking component of OpenStack
|
|
assigns and configures an IP address.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Set the host name to <literal>compute1</literal>. To
|
|
verify, use the <code>uname -n</code> parameter. Ensure
|
|
that the IP addresses and host names for both nodes are
|
|
listed in the <filename>/etc/hosts</filename> file on each
|
|
system.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Synchronize from the controller node. Follow the
|
|
instructions in <xref linkend="basics-ntp"/>.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Install the MySQL client libraries. You do not need to
|
|
install the MySQL database server or start the MySQL
|
|
service.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Enable the OpenStack packages for the distribution
|
|
that you are using. See <xref linkend="basics-packages"
|
|
/>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</step>
|
|
<step>
|
|
<para>After you configure the operating system, install the
|
|
appropriate packages for the Compute service.</para>
|
|
<para os="ubuntu;debian">Run this command:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-compute-kvm python-guestfs</userinput></screen>
|
|
<para os="ubuntu;debian">When prompted to create a
|
|
<literal>supermin</literal> appliance, respond
|
|
<userinput>yes</userinput>.</para>
|
|
|
|
<note os="debian">
|
|
<para>To use the meta-packages and install other components on
|
|
your compute node, such as OVS Networking and Ceilometer
|
|
agents, run this command:</para>
|
|
<screen><prompt>#</prompt> <userinput>apt-get install openstack-compute-node</userinput></screen>
|
|
<para>The controller node has the
|
|
<package>openstack-proxy-node</package> and
|
|
<package>openstack-toaster</package> meta-packages that
|
|
install <package>openstack-proxy-node</package> and
|
|
<package>openstack-toaster</package> at the same
|
|
time.</para>
|
|
</note>
|
|
|
|
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-nova-compute</userinput></screen>
|
|
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-compute kvm openstack-utils</userinput></screen>
|
|
</step>
|
|
<step os="debian">
|
|
<para>Respond to the prompts for <link
|
|
linkend="debconf-dbconfig-common">database
|
|
management</link>, <link linkend="debconf-keystone_authtoken"
|
|
><literal>[keystone_authtoken]</literal> settings</link>,
|
|
<link linkend="debconf-rabbitqm">RabbitMQ
|
|
credentials</link>, and <link linkend="debconf-api-endpoints"
|
|
>API endpoint</link> registration.</para>
|
|
</step>
|
|
<step os="ubuntu">
|
|
<para>Due to <link
|
|
xlink:href="https://bugs.launchpad.net/ubuntu/+source/linux/+bug/759725"
|
|
>this bug</link>, which is marked <literal>Won't
|
|
Fix</literal>, guestfs is restricted. Run this command to
|
|
relax the restriction:</para>
|
|
<screen><prompt>#</prompt> <userinput>chmod 0644 /boot/vmlinuz*</userinput></screen>
|
|
</step>
|
|
<step os="rhel;centos;fedora">
|
|
<para>Edit the <filename>/etc/nova/nova.conf</filename> configuration file:</para>
|
|
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf database connection mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@controller/nova</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_strategy keystone</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT auth_host <replaceable>controller</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_user nova</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_tenant_name service</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT admin_password <replaceable>NOVA_PASS</replaceable></userinput></screen>
|
|
<screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT rpc_backend nova.openstack.common.rpc.impl_qpid</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT qpid_hostname <replaceable>controller</replaceable></userinput></screen>
|
|
<para os="ubuntu;debian">Edit the
|
|
<filename>/etc/nova/nova.conf</filename> configuration file and add these
|
|
lines to the appropriate sections:</para>
|
|
<programlisting os="ubuntu;debian" language="ini">...
|
|
[DEFAULT]
|
|
...
|
|
auth_strategy=keystone
|
|
...
|
|
[database]
|
|
# The SQLAlchemy connection string used to connect to the database
|
|
connection = mysql://nova:NOVA_DBPASS@controller/nova</programlisting>
|
|
</step>
|
|
<step os="ubuntu;debian">
|
|
<para>Configure the Compute service to use the RabbitMQ message
|
|
broker by setting these configuration keys in the
|
|
<literal>DEFAULT</literal> configuration group of the
|
|
<filename>/etc/nova/nova.conf</filename> file:</para>
|
|
<programlisting os="ubuntu;debian" language="ini">
|
|
rpc_backend = nova.rpc.impl_kombu
|
|
rabbit_host = controller</programlisting>
|
|
</step>
|
|
|
|
<step os="ubuntu">
|
|
<para>Remove the SQLite database created by the packages:</para>
|
|
<screen><prompt>#</prompt> <userinput>rm /var/lib/nova/nova.sqlite</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Set the <literal>my_ip</literal>,
|
|
<literal>vncserver_listen</literal>, and
|
|
<literal>vncserver_proxyclient_address</literal>
|
|
configuration keys to the IP address of the compute node on
|
|
the internal network:</para>
|
|
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 192.168.0.11</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 192.168.0.11</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 192.168.0.11</userinput></screen>
|
|
<para os="ubuntu;debian">Edit
|
|
<filename>/etc/nova/nova.conf</filename> and add to the
|
|
<literal>[DEFAULT]</literal> section.</para>
|
|
<programlisting os="ubuntu;debian" language="ini">[DEFAULT]
|
|
...
|
|
my_ip=192.168.0.11
|
|
vncserver_listen=0.0.0.0
|
|
vncserver_proxyclient_address=192.168.0.11</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>Specify the host that runs the Image Service.<phrase
|
|
os="ubuntu;debian"> Edit
|
|
<filename>/etc/nova/nova.conf</filename> file and add
|
|
these lines to the <literal>[DEFAULT]</literal>
|
|
section:</phrase></para>
|
|
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT glance_host <replaceable>controller</replaceable></userinput></screen>
|
|
<programlisting os="ubuntu;debian" language="ini">[DEFAULT]
|
|
...
|
|
glance_host=<replaceable>controller</replaceable></programlisting>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Edit the <filename>/etc/nova/api-paste.ini</filename>
|
|
configuration file to add the credentials to the
|
|
<literal>[filter:authtoken]</literal> section:</para>
|
|
<programlisting language="ini">[filter:authtoken]
|
|
paste.filter_factory=keystoneclient.middleware.auth_token:filter_factory
|
|
auth_host=controller
|
|
auth_port = 35357
|
|
auth_protocol = http
|
|
admin_user=nova
|
|
admin_tenant_name=service
|
|
admin_password=<replaceable>NOVA_PASS</replaceable>
|
|
</programlisting>
|
|
<note os="fedora;rhel;centos;opensuse;sles">
|
|
<para>Ensure that the
|
|
<option>api_paste_config=/etc/nova/api-paste.ini</option>
|
|
option is set in <filename>/etc/nova/nova.conf</filename>
|
|
file.</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para os="fedora;rhel;centos;opensuse;sles">Start the Compute
|
|
service and configure it to start when the system
|
|
boots.</para>
|
|
<para os="ubuntu;debian">Restart the Compute service.</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-compute restart</userinput></screen>
|
|
<screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>service libvirtd start</userinput>
|
|
<prompt>#</prompt> <userinput>service messagebus start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig libvirtd on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig messagebus on</userinput></screen>
|
|
<screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-compute start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-nova-compute on</userinput>
|
|
<prompt>#</prompt> <userinput>service libvirtd start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig libvirtd on</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|