Merge "Improved install guide nova controller section"
This commit is contained in:
Jenkins
@@ -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