Improved install guide nova controller section
I improved the nova controller section of the installation guide as follows: 1) Restructured steps to improve flow/clarity and consistency with similar sections. 2) Explicitly sourced admin-openrc.sh. 3) Explicitly configured 'glance_host' key. 4) Adjusted titles. 5) Split single verify step into separate section after installation on compute node and added another command to run. Most of these improvements incorporate changes approved for other patches associated with this blueprint. A future patch will cover improvements to the nova compute node section. Change-Id: I12bc6c4f2a05a55ecbec3b17e3477a002cde4e1a Implements: blueprint installation-guide-improvements
This commit is contained in:
Matthew Kassawara
@@ -4,8 +4,9 @@
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
||||
xml:id="ch_nova">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Add the Compute services</title>
|
||||
<title>Add the Compute service</title>
|
||||
<xi:include href="../common/section_getstart_compute.xml"/>
|
||||
<xi:include href="section_nova-controller.xml"/>
|
||||
<xi:include href="section_nova-controller-install.xml"/>
|
||||
<xi:include href="section_nova-compute.xml"/>
|
||||
<xi:include href="section_nova-verify.xml"/>
|
||||
</chapter>
|
||||
|
||||
228
doc/install-guide/section_nova-controller-install.xml
Normal file
228
doc/install-guide/section_nova-controller-install.xml
Normal file
@@ -0,0 +1,228 @@
|
||||
<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-controller-install">
|
||||
<title>Install and configure controller node</title>
|
||||
<para>This section describes how to install and configure the Compute
|
||||
service, code-named nova, on the controller node.</para>
|
||||
<procedure os="ubuntu;rhel;centos;fedora;sles;opensuse">
|
||||
<title>To configure prerequisites</title>
|
||||
<para>Before you install and configure Compute, you must create a database
|
||||
and Identity service credentials including endpoints.</para>
|
||||
<step>
|
||||
<para>To create the database, complete these steps:</para>
|
||||
<substeps>
|
||||
<step>
|
||||
<para>Use the database access client to connect to the database
|
||||
server as the <literal>root</literal> user:</para>
|
||||
<screen><prompt>$</prompt> <userinput>mysql -u root -p</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Create the <literal>nova</literal> database:</para>
|
||||
<screen><prompt>mysql></prompt> <userinput>CREATE DATABASE nova;</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Grant proper access to the <literal>nova</literal>
|
||||
database:</para>
|
||||
<screen><prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput>
|
||||
<prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput></screen>
|
||||
<para>Replace <replaceable>NOVA_DBPASS</replaceable> with a suitable
|
||||
password.</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>Exit the database access client:</para>
|
||||
<screen><prompt>mysql></prompt> <userinput>exit</userinput></screen>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
<step>
|
||||
<para>Source the <literal>admin</literal> credentials to gain access to
|
||||
admin-only CLI commands:</para>
|
||||
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>To create the Identity service credentials, complete these
|
||||
steps:</para>
|
||||
<substeps>
|
||||
<step>
|
||||
<para>Create the <literal>nova</literal> user:</para>
|
||||
<screen><prompt>$</prompt> <userinput>keystone user-create --name=nova --pass=<replaceable>NOVA_PASS</replaceable> --email=<replaceable>EMAIL_ADDRESS</replaceable></userinput></screen>
|
||||
<para>Replace <replaceable>NOVA_PASS</replaceable> with a suitable
|
||||
password and <replaceable>EMAIL_ADDRESS</replaceable> with
|
||||
a suitable e-mail address.</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>Link the <literal>nova</literal> user to the
|
||||
<literal>service</literal> tenant and <literal>admin</literal>
|
||||
role:</para>
|
||||
<screen><prompt>$</prompt> <userinput>keystone user-role-add --user=nova --tenant=service --role=admin</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Create the <literal>nova</literal> service:</para>
|
||||
<screen><prompt>$</prompt> <userinput>keystone service-create --name=nova --type=compute --description="OpenStack Compute"</userinput></screen>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
<step>
|
||||
<para>Create the Compute service endpoints:</para>
|
||||
<screen><prompt>$</prompt> <userinput>keystone endpoint-create \
|
||||
--service-id=$(keystone service-list | awk '/ compute / {print $2}') \
|
||||
--publicurl=http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
|
||||
--internalurl=http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
|
||||
--adminurl=http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure os="ubuntu;rhel;centos;fedora;sles;opensuse">
|
||||
<title>To install and configure Compute controller components</title>
|
||||
<step>
|
||||
<para>Install the packages:</para>
|
||||
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-api nova-cert nova-conductor nova-consoleauth \
|
||||
nova-novncproxy nova-scheduler python-novaclient</userinput></screen>
|
||||
<screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>yum install openstack-nova-api openstack-nova-cert openstack-nova-conductor \
|
||||
openstack-nova-console openstack-nova-novncproxy openstack-nova-scheduler \
|
||||
python-novaclient</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-api openstack-nova-scheduler \
|
||||
openstack-nova-cert openstack-nova-conductor openstack-nova-console \
|
||||
openstack-nova-consoleauth openstack-nova-novncproxy python-novaclient</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/nova/nova.conf</filename> file and
|
||||
complete the following actions:</para>
|
||||
<substeps>
|
||||
<step>
|
||||
<para>In the <literal>[database]</literal> section, configure
|
||||
database access:</para>
|
||||
<programlisting language="ini">[database]
|
||||
...
|
||||
connection = mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@controller/nova</programlisting>
|
||||
<para>Replace <replaceable>NOVA_DBPASS</replaceable> with the
|
||||
password you chose for the Compute database.</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>In the <literal>[DEFAULT]</literal> section, configure
|
||||
<application>RabbitMQ</application> message broker access:</para>
|
||||
<programlisting language="ini">[DEFAULT]
|
||||
...
|
||||
rpc_backend = rabbit
|
||||
rabbit_host = <replaceable>controller</replaceable>
|
||||
rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
|
||||
<para>Replace <replaceable>RABBIT_PASS</replaceable> with the
|
||||
password you chose for the <literal>guest</literal> account in
|
||||
<application>RabbitMQ</application>.</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>In the <literal>[keystone_authtoken]</literal> section,
|
||||
configure Identity service access:</para>
|
||||
<programlisting language="ini">
|
||||
[keystone_authtoken]
|
||||
...
|
||||
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0
|
||||
auth_host = <replaceable>controller</replaceable>
|
||||
auth_port = 35357
|
||||
auth_protocol = http
|
||||
admin_tenant_name = service
|
||||
admin_user = nova
|
||||
admin_password = <replaceable>NOVA_PASS</replaceable></programlisting>
|
||||
<para>Replace <replaceable>NOVA_PASS</replaceable> with the password
|
||||
you chose for the <literal>nova</literal> user in the Identity
|
||||
service.</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>In the <literal>[DEFAULT]</literal> section, configure the
|
||||
<literal>my_ip</literal> key to use the management interface IP
|
||||
address of the controller node:</para>
|
||||
<programlisting language="ini">[DEFAULT]
|
||||
...
|
||||
my_ip = 10.0.0.11</programlisting>
|
||||
</step>
|
||||
<step>
|
||||
<para>In the <literal>[DEFAULT]</literal> section, configure the
|
||||
VNC proxy to use the management interface IP address of the
|
||||
controller node:</para>
|
||||
<programlisting language="ini">[DEFAULT]
|
||||
...
|
||||
vncserver_listen = 10.0.0.11
|
||||
vncserver_proxyclient_address = 10.0.0.11</programlisting>
|
||||
</step>
|
||||
<step>
|
||||
<para>In the <literal>[DEFAULT]</literal> section, configure the
|
||||
location of the Image Service:</para>
|
||||
<programlisting language="ini">[DEFAULT]
|
||||
...
|
||||
glance_host = <replaceable>controller</replaceable></programlisting>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
<step>
|
||||
<para>Populate the Compute database:</para>
|
||||
<screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "nova-manage db sync" nova</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure os="debian">
|
||||
<title>To install and configure the Compute controller components</title>
|
||||
<step>
|
||||
<para>Install the packages:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get install nova-api nova-cert nova-conductor nova-consoleauth \
|
||||
nova-novncproxy nova-scheduler python-novaclient</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Respond to prompts for
|
||||
<link linkend="debconf-dbconfig-common">database management</link>,
|
||||
<link linkend="debconf-keystone_authtoken">Identity service
|
||||
credentials</link>,
|
||||
<link linkend="debconf-api-endpoints">service endpoint
|
||||
registration</link>, and
|
||||
<link linkend="debconf-rabbitmq">message broker
|
||||
credentials</link>.</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/nova/nova.conf</filename> file and
|
||||
complete the following actions:</para>
|
||||
<substeps>
|
||||
<step>
|
||||
<para>In the <literal>[DEFAULT]</literal> section, configure the VNC
|
||||
proxy to use the management interface IP address of the controller
|
||||
node:</para>
|
||||
<programlisting language="ini">[DEFAULT]
|
||||
...
|
||||
vncserver_listen = 10.0.0.11
|
||||
vncserver_proxyclient_address = 10.0.0.11</programlisting>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure>
|
||||
<title>To finalize installation</title>
|
||||
<step os="ubuntu;debian">
|
||||
<para>Restart the Compute services:</para>
|
||||
<screen><prompt>#</prompt> <userinput>service nova-api restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-cert restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-consoleauth restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-scheduler restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-conductor restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-novncproxy restart</userinput></screen>
|
||||
</step>
|
||||
<step os="rhel;centos;fedora;sles;opensuse">
|
||||
<para>Start the Compute services and configure them to start when the
|
||||
system boots:</para>
|
||||
<screen><prompt>#</prompt> <userinput>service openstack-nova-api start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-cert start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-consoleauth start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-scheduler start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-conductor start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-novncproxy start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-api on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-cert on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-consoleauth on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-scheduler on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-conductor on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-novncproxy on</userinput></screen>
|
||||
</step>
|
||||
<step os="ubuntu">
|
||||
<para>By default, the Ubuntu packages create an SQLite database.</para>
|
||||
<para>Because this configuration uses a SQL database server, you can
|
||||
remove the SQLite database file:</para>
|
||||
<screen><prompt>#</prompt> <userinput>rm /var/lib/nova/nova.sqlite</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
@@ -1,200 +0,0 @@
|
||||
<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-controller">
|
||||
<title>Install Compute controller services</title>
|
||||
<para>Compute is a collection of services that enable you to launch
|
||||
virtual machine instances. You can configure these services to run
|
||||
on separate nodes or the same node. In this guide, most services
|
||||
run on the controller node and the service that launches virtual
|
||||
machines runs on a dedicated compute node. This section shows you
|
||||
how to install and configure these services on the controller
|
||||
node.</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para>Install the Compute packages necessary for the controller
|
||||
node.</para>
|
||||
<screen os="fedora;rhel;centos"><prompt>#</prompt> <userinput>yum install openstack-nova-api openstack-nova-cert openstack-nova-conductor \
|
||||
openstack-nova-console openstack-nova-novncproxy openstack-nova-scheduler \
|
||||
python-novaclient</userinput></screen>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-api nova-cert nova-conductor nova-consoleauth \
|
||||
nova-novncproxy nova-scheduler python-novaclient</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-nova-api openstack-nova-scheduler \
|
||||
openstack-nova-cert openstack-nova-conductor openstack-nova-console \
|
||||
openstack-nova-consoleauth openstack-nova-novncproxy python-novaclient</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-rabbitmq">RabbitMQ
|
||||
credentials</link>, and <link linkend="debconf-api-endpoints"
|
||||
>API endpoint</link> registration. The <command>nova-manage
|
||||
db sync</command> command runs automatically.</para>
|
||||
</step>
|
||||
|
||||
<step os="opensuse;sles;fedora;rhel;centos;ubuntu">
|
||||
<para>Compute stores information in a database. In this guide, we
|
||||
use a MySQL database on the controller node. Configure Compute
|
||||
with the database location and credentials. Replace
|
||||
<replaceable>NOVA_DBPASS</replaceable> with the password for the
|
||||
database that you will create in a later step.</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>@<replaceable>controller</replaceable>/nova</userinput></screen>
|
||||
<para os="ubuntu">Edit the <literal>[database]</literal> section
|
||||
in the <filename>/etc/nova/nova.conf</filename> file, adding it if
|
||||
necessary, to modify this
|
||||
key:</para>
|
||||
<programlisting os="ubuntu" language="ini">
|
||||
[database]
|
||||
connection = mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@controller/nova</programlisting>
|
||||
</step>
|
||||
|
||||
<step os="ubuntu">
|
||||
<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 language="ini">[DEFAULT]
|
||||
...
|
||||
rpc_backend = rabbit
|
||||
rabbit_host = controller
|
||||
rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
|
||||
</step>
|
||||
<step os="opensuse;sles;rhel;centos;fedora">
|
||||
<para>Set these configuration keys to configure Compute to use
|
||||
the RabbitMQ message broker:</para>
|
||||
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \
|
||||
DEFAULT rpc_backend nova.rpc.impl_kombu</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT rabbit_host controller</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT rabbit_password <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Set the <option>my_ip</option>,
|
||||
<option>vncserver_listen</option>, and
|
||||
<option>vncserver_proxyclient_address</option>
|
||||
configuration options to the management interface IP address of the
|
||||
controller node:</para>
|
||||
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT my_ip 10.0.0.11</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_listen 10.0.0.11</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT vncserver_proxyclient_address 10.0.0.11</userinput></screen>
|
||||
<para os="ubuntu">Edit the
|
||||
<filename>/etc/nova/nova.conf</filename> file and add these
|
||||
lines to the <literal>[DEFAULT]</literal> section:</para>
|
||||
<para os="debian">In Debian, the <package>debconf</package>
|
||||
package automatically sets up <literal>my_ip</literal>
|
||||
parameter but you must edit the
|
||||
<filename>/etc/nova/nova.conf</filename> file to configure
|
||||
the <option>vncserver_listen</option> and
|
||||
<option>vncserver_proxyclient_address</option> options,
|
||||
which appear at the end of the file:</para>
|
||||
<programlisting os="ubuntu;debian" language="ini">[DEFAULT]
|
||||
...
|
||||
my_ip = 10.0.0.11
|
||||
vncserver_listen = 10.0.0.11
|
||||
vncserver_proxyclient_address = 10.0.0.11</programlisting>
|
||||
</step>
|
||||
|
||||
<step os="ubuntu">
|
||||
<para>By default, the Ubuntu packages create an SQLite database.
|
||||
Delete the <filename>nova.sqlite</filename> file created in
|
||||
the <filename>/var/lib/nova/</filename> directory so that it
|
||||
does not get used by mistake:</para>
|
||||
<screen><prompt>#</prompt> <userinput>rm /var/lib/nova/nova.sqlite</userinput></screen>
|
||||
</step>
|
||||
<step os="ubuntu;rhel;centos;fedora;opensuse;sles">
|
||||
<para>Use the password you created previously to log in as root.
|
||||
Create a <literal>nova</literal> database user:</para>
|
||||
<screen><prompt>$</prompt> <userinput>mysql -u root -p</userinput>
|
||||
<prompt>mysql></prompt> <userinput>CREATE DATABASE nova;</userinput>
|
||||
<prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' \
|
||||
IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput>
|
||||
<prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' \
|
||||
IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput></screen>
|
||||
</step>
|
||||
<step os="ubuntu;rhel;centos;fedora">
|
||||
<para>Create the Compute service tables:</para>
|
||||
<screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "nova-manage db sync" nova</userinput></screen>
|
||||
</step>
|
||||
<step os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
||||
<para>Create a <literal>nova</literal> user that Compute uses to
|
||||
authenticate with the Identity Service. Use the
|
||||
<literal>service</literal> tenant and give the user the
|
||||
<literal>admin</literal> role:</para>
|
||||
<screen><prompt>$</prompt> <userinput>keystone user-create --name=nova --pass=<replaceable>NOVA_PASS</replaceable> --email=<replaceable>nova@example.com</replaceable></userinput>
|
||||
<prompt>$</prompt> <userinput>keystone user-role-add --user=nova --tenant=service --role=admin</userinput></screen>
|
||||
</step>
|
||||
<step os="opensuse;sles;fedora;rhel;centos;ubuntu">
|
||||
<para>Configure Compute to use these credentials with the Identity
|
||||
Service running on the controller. Replace
|
||||
<replaceable>NOVA_PASS</replaceable> with your Compute password.</para>
|
||||
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken auth_uri http://<replaceable>controller</replaceable>:5000</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken auth_host <replaceable>controller</replaceable></userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken auth_protocol http</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken auth_port 35357</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken admin_user nova</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken admin_tenant_name service</userinput>
|
||||
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf keystone_authtoken admin_password <replaceable>NOVA_PASS</replaceable></userinput></screen>
|
||||
<para os="ubuntu">Add these keys to the
|
||||
<literal>[keystone_authtoken]</literal> section:</para>
|
||||
<programlisting os="ubuntu" language="ini">
|
||||
[keystone_authtoken]
|
||||
...
|
||||
auth_uri = http://<replaceable>controller</replaceable>:5000
|
||||
auth_host = controller
|
||||
auth_port = 35357
|
||||
auth_protocol = http
|
||||
admin_tenant_name = service
|
||||
admin_user = nova
|
||||
admin_password = <replaceable>NOVA_PASS</replaceable></programlisting>
|
||||
</step>
|
||||
<step os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
||||
<para>You must register Compute with the Identity Service so
|
||||
that other OpenStack services can locate it. Register the
|
||||
service and specify the endpoint:</para>
|
||||
|
||||
<screen><prompt>$</prompt> <userinput>keystone service-create --name=nova --type=compute \
|
||||
--description="OpenStack Compute"</userinput>
|
||||
<prompt>$</prompt> <userinput>keystone endpoint-create \
|
||||
--service-id=$(keystone service-list | awk '/ compute / {print $2}') \
|
||||
--publicurl=http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
|
||||
--internalurl=http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
|
||||
--adminurl=http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s</userinput></screen>
|
||||
</step>
|
||||
<step os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
||||
<para os="centos;fedora;rhel;opensuse;sles">Start Compute
|
||||
services and configure them to start when the system
|
||||
boots:</para>
|
||||
<para os="ubuntu">Restart Compute services:</para>
|
||||
<screen os="ubuntu"><prompt>#</prompt> <userinput>service nova-api restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-cert restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-consoleauth restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-scheduler restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-conductor restart</userinput>
|
||||
<prompt>#</prompt> <userinput>service nova-novncproxy restart</userinput></screen>
|
||||
<screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-api start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-cert start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-consoleauth start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-scheduler start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-conductor start</userinput>
|
||||
<prompt>#</prompt> <userinput>service openstack-nova-novncproxy start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-api on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-cert on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-consoleauth on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-scheduler on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-conductor on</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig openstack-nova-novncproxy on</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>To verify your configuration, list available
|
||||
images:</para>
|
||||
<screen><prompt>$</prompt> <userinput>nova image-list</userinput>
|
||||
<computeroutput>+--------------------------------------+---------------------+--------+--------+
|
||||
| ID | Name | Status | Server |
|
||||
+--------------------------------------+---------------------+--------+--------+
|
||||
| acafc7c0-40aa-4026-9673-b879898e1fc2 | cirros-0.3.2-x86_64 | ACTIVE | |
|
||||
+--------------------------------------+---------------------+--------+--------+</computeroutput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
46
doc/install-guide/section_nova-verify.xml
Normal file
46
doc/install-guide/section_nova-verify.xml
Normal file
@@ -0,0 +1,46 @@
|
||||
<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-verify">
|
||||
<title>Verify operation</title>
|
||||
<para>This section describes how to verify operation of the Compute
|
||||
service.</para>
|
||||
<procedure>
|
||||
<note>
|
||||
<para>Perform these commands on the controller node.</para>
|
||||
</note>
|
||||
<step>
|
||||
<para>Source the <literal>admin</literal> credentials to gain access to
|
||||
admin-only CLI commands:</para>
|
||||
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>List service components to verify successful launch of each
|
||||
process:</para>
|
||||
<screen><prompt>$</prompt> <userinput>nova service-list</userinput>
|
||||
<computeroutput>+------------------+-------------+----------+---------+-------+----------------------------+-----------------+
|
||||
| Binary | Host | Zone | Status | State | Updated_at | Disabled Reason |
|
||||
+------------------+-------------+----------+---------+-------+----------------------------+-----------------+
|
||||
| nova-cert | controller | internal | enabled | up | 2014-06-29T22:23:16.000000 | - |
|
||||
| nova-consoleauth | controller | internal | enabled | up | 2014-06-29T22:23:10.000000 | - |
|
||||
| nova-scheduler | controller | internal | enabled | up | 2014-06-29T22:23:14.000000 | - |
|
||||
| nova-conductor | controller | internal | enabled | up | 2014-06-29T22:23:11.000000 | - |
|
||||
| nova-compute | compute1 | nova | enabled | up | 2014-06-29T22:23:11.000000 | - |
|
||||
+------------------+-------------+----------+---------+-------+----------------------------+-----------------+</computeroutput></screen>
|
||||
<note>
|
||||
<para>This output should indicate four components enabled on the
|
||||
controller node one component enabled on the compute node.</para>
|
||||
</note>
|
||||
</step>
|
||||
<step>
|
||||
<para>List images in the Image Service catalog to verify connectivity
|
||||
with the Identity service and Image Service:</para>
|
||||
<screen><prompt>$</prompt> <userinput>nova image-list</userinput>
|
||||
<computeroutput>+--------------------------------------+---------------------+--------+--------+
|
||||
| ID | Name | Status | Server |
|
||||
+--------------------------------------+---------------------+--------+--------+
|
||||
| acafc7c0-40aa-4026-9673-b879898e1fc2 | cirros-0.3.2-x86_64 | ACTIVE | |
|
||||
+--------------------------------------+---------------------+--------+--------+</computeroutput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
Reference in New Issue
Block a user