openstack/openstack-manuals
Code Issues Proposed changes

Modify nova content for Kilo

Browse Source 
Modify nova content for Kilo as follows:

1) Change python-keystoneclient to python-openstackclient.

2) Move RabbitMQ configuration to [oslo_messaging_rabbit]
   section.

3) Use "openstack" account for RabbitMQ.

4) Remove version from auth_uri option.

5) Add note about differing stock configuration files and usage
   of ellipsis in configuration snippets.

6) Add "nova endpoints" to verification procedure.

Implements: blueprint installguide-kilo
Change-Id: Ib5116fefb013bc4727a87c363ffb1f557810814d
This commit is contained in:
Matthew Kassawara
2015-03-27 07:40:59 -05:00
parent b79f4ecd26
commit 68db779d0e
3 changed files with 171 additions and 56 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
doc/install-guide/section_nova-compute-install.xml
View File

@@ -38,6 +38,13 @@
</note> </note>
<procedure os="ubuntu;rhel;centos;fedora;sles;opensuse"> <procedure os="ubuntu;rhel;centos;fedora;sles;opensuse">
<title>To install and configure the Compute hypervisor components</title> <title>To install and configure the Compute hypervisor components</title>
<note>
<para>Default configuration files vary by distribution. You might need
to add these sections and options rather than modifying existing
sections and options. Also, an ellipsis (...) in the configuration
snippets indicates potential default configuration options that you
should retain.</para>
</note>
<step> <step>
<para>Install the packages:</para> <para>Install the packages:</para>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-compute sysfsutils</userinput></screen> <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-compute sysfsutils</userinput></screen>
@@ -49,15 +56,20 @@
complete the following actions:</para> complete the following actions:</para>
<substeps> <substeps>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, configure <para>In the <literal>[DEFAULT]</literal> and
<application>RabbitMQ</application> message broker access:</para> <literal>[oslo_messaging_rabbit]</literal> sections, configure
<application>RabbitMQ</application> message queue access:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
rpc_backend = rabbit rpc_backend = rabbit
[oslo_messaging_rabbit]
...
rabbit_host = <replaceable>controller</replaceable> rabbit_host = <replaceable>controller</replaceable>
rabbit_userid = openstack
rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting> rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<para>Replace <replaceable>RABBIT_PASS</replaceable> with the password <para>Replace <replaceable>RABBIT_PASS</replaceable> with the password
you chose for the <literal>guest</literal> account in you chose for the <literal>openstack</literal> account in
<application>RabbitMQ</application>.</para> <application>RabbitMQ</application>.</para>
</step> </step>
<step> <step>
@@ -70,7 +82,7 @@ auth_strategy = keystone
[keystone_authtoken] [keystone_authtoken]
... ...
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0 auth_uri = http://<replaceable>controller</replaceable>:5000
identity_uri = http://<replaceable>controller</replaceable>:35357 identity_uri = http://<replaceable>controller</replaceable>:35357
admin_tenant_name = service admin_tenant_name = service
admin_user = nova admin_user = nova
@@ -173,7 +185,7 @@ verbose = True</programlisting>
credentials</link>, credentials</link>,
<link linkend="debconf-api-endpoints">service endpoint <link linkend="debconf-api-endpoints">service endpoint
registration</link>, and registration</link>, and
<link linkend="debconf-rabbitmq">message broker <link linkend="debconf-rabbitmq">message queue
credentials.</link>.</para> credentials.</link>.</para>
</step> </step>
</procedure> </procedure>

101
doc/install-guide/section_nova-controller-install.xml
View File

@@ -50,67 +50,77 @@
<substeps> <substeps>
<step> <step>
<para>Create the <literal>nova</literal> user:</para> <para>Create the <literal>nova</literal> user:</para>
<screen><prompt>$</prompt> <userinput>keystone user-create --name nova --pass <replaceable>NOVA_PASS</replaceable></userinput> <screen><prompt>$</prompt> <userinput>openstack user create --password-prompt nova</userinput>
<computeroutput>+----------+----------------------------------+ <computeroutput>User Password:
| Property | Value | Repeat User Password:
+----------+----------------------------------+ +----------+----------------------------------+
| email | | | Field | Value |
| enabled | True |
| id | 387dd4f7e46d4f72965ee99c76ae748c |
| name | nova |
| username | nova |
+----------+----------------------------------+ +----------+----------------------------------+
</computeroutput></screen> | email | None |
<para>Replace <replaceable>NOVA_PASS</replaceable> with | enabled | True |
a suitable password.</para> | id | 8e0b71d732db4bfba04943a96230c8c0 |
| name | nova |
| username | nova |
+----------+----------------------------------+</computeroutput></screen>
</step> </step>
<step> <step>
<para>Add the <literal>admin</literal> role to the <para>Add the <literal>admin</literal> role to the
<literal>nova</literal> user:</para> <literal>nova</literal> user:</para>
<screen><prompt>$</prompt> <userinput>keystone user-role-add --user nova --tenant service --role admin</userinput></screen> <screen><prompt>$</prompt> <userinput>openstack role add --project service --user nova admin</userinput>
<note> <computeroutput>+-------+----------------------------------+
<para>This command provides no output.</para> | Field | Value |
</note> +-------+----------------------------------+
| id | 1169d778631b4fd1aefd9d35314e1c56 |
| name | admin |
+-------+----------------------------------+</computeroutput></screen>
</step> </step>
<step> <step>
<para>Create the <literal>nova</literal> service entity:</para> <para>Create the <literal>nova</literal> service entity:</para>
<screen><prompt>$</prompt> <userinput>keystone service-create --name nova --type compute \ <screen><prompt>$</prompt> <userinput>openstack service create --type compute \
--description "OpenStack Compute"</userinput> --description "OpenStack Compute" nova</userinput>
<computeroutput>+-------------+----------------------------------+ <computeroutput>+-------------+----------------------------------+
| Property | Value | | Field | Value |
+-------------+----------------------------------+ +-------------+----------------------------------+
| description | OpenStack Compute | | description | OpenStack Compute |
| enabled | True | | enabled | True |
| id | 6c7854f52ce84db795557ebc0373f6b9 | | id | 060d59eac51b4594815603d75a00aba2 |
| name | nova | | name | nova |
| type | compute | | type | compute |
+-------------+----------------------------------+ +-------------+----------------------------------+</computeroutput></screen>
</computeroutput></screen>
</step> </step>
</substeps> </substeps>
</step> </step>
<step> <step>
<para>Create the Compute service API endpoints:</para> <para>Create the Compute service API endpoints:</para>
<screen><prompt>$</prompt> <userinput>keystone endpoint-create \ <screen><prompt>$</prompt> <userinput>openstack endpoint create
--service-id $(keystone service-list | awk '/ compute / {print $2}') \
--publicurl http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \ --publicurl http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
--internalurl 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 \ --adminurl http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
--region regionOne</userinput> --region regionOne
<computeroutput>+-------------+-----------------------------------------+ compute</userinput>
| Property | Value | <computeroutput>+--------------+------------------------------------------+
+-------------+-----------------------------------------+ | Field | Value |
| adminurl | http://controller:8774/v2/%(tenant_id)s | +--------------+------------------------------------------+
| id | c397438bd82c41198ec1a9d85cb7cc74 | | adminurl | http://msk-os4ctl1:8774/v2/%(tenant_id)s |
| internalurl | http://controller:8774/v2/%(tenant_id)s | | id | 4e885d4ad43f4c4fbf2287734bc58d6b |
| publicurl | http://controller:8774/v2/%(tenant_id)s | | internalurl | http://msk-os4ctl1:8774/v2/%(tenant_id)s |
| region | regionOne | | publicurl | http://msk-os4ctl1:8774/v2/%(tenant_id)s |
| service_id | 6c7854f52ce84db795557ebc0373f6b9 | | region | regionOne |
+-------------+-----------------------------------------+</computeroutput></screen> | service_id | 060d59eac51b4594815603d75a00aba2 |
| service_name | nova |
| service_type | compute |
+--------------+------------------------------------------+</computeroutput></screen>
</step> </step>
</procedure> </procedure>
<procedure os="ubuntu;rhel;centos;fedora;sles;opensuse"> <procedure os="ubuntu;rhel;centos;fedora;sles;opensuse">
<title>To install and configure Compute controller components</title> <title>To install and configure Compute controller components</title>
<note>
<para>Default configuration files vary by distribution. You might need
to add these sections and options rather than modifying existing
sections and options. Also, an ellipsis (...) in the configuration
snippets indicates potential default configuration options that you
should retain.</para>
</note>
<step> <step>
<para>Install the packages:</para> <para>Install the packages:</para>
<screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-api nova-cert nova-conductor nova-consoleauth \ <screen os="ubuntu"><prompt>#</prompt> <userinput>apt-get install nova-api nova-cert nova-conductor nova-consoleauth \
@@ -136,15 +146,20 @@ connection = mysql://nova:<replaceable>NOVA_DBPASS</replaceable>@controller/nova
password you chose for the Compute database.</para> password you chose for the Compute database.</para>
</step> </step>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, configure <para>In the <literal>[DEFAULT]</literal> and
<application>RabbitMQ</application> message broker access:</para> <literal>[oslo_messaging_rabbit]</literal> sections, configure
<application>RabbitMQ</application> message queue access:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
rpc_backend = rabbit rpc_backend = rabbit
[oslo_messaging_rabbit]
...
rabbit_host = <replaceable>controller</replaceable> rabbit_host = <replaceable>controller</replaceable>
rabbit_userid = openstack
rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting> rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<para>Replace <replaceable>RABBIT_PASS</replaceable> with the <para>Replace <replaceable>RABBIT_PASS</replaceable> with the
password you chose for the <literal>guest</literal> account in password you chose for the <literal>openstack</literal> account in
<application>RabbitMQ</application>.</para> <application>RabbitMQ</application>.</para>
</step> </step>
<step> <step>
@@ -157,7 +172,7 @@ auth_strategy = keystone
[keystone_authtoken] [keystone_authtoken]
... ...
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0 auth_uri = http://<replaceable>controller</replaceable>:5000
identity_uri = http://<replaceable>controller</replaceable>:35357 identity_uri = http://<replaceable>controller</replaceable>:35357
admin_tenant_name = service admin_tenant_name = service
admin_user = nova admin_user = nova
@@ -224,7 +239,7 @@ verbose = True</programlisting>
credentials</link>, credentials</link>,
<link linkend="debconf-api-endpoints">service endpoint <link linkend="debconf-api-endpoints">service endpoint
registration</link>, and registration</link>, and
<link linkend="debconf-rabbitmq">message broker <link linkend="debconf-rabbitmq">message queue
credentials</link>.</para> credentials</link>.</para>
</step> </step>
<step> <step>

104
doc/install-guide/section_nova-verify.xml
View File

@@ -5,8 +5,7 @@
version="5.0" version="5.0"
xml:id="nova-verify"> xml:id="nova-verify">
<title>Verify operation</title> <title>Verify operation</title>
<para>This section describes how to verify operation of the Compute <para>Verify operation of the Compute service.</para>
service.</para>
<procedure> <procedure>
<note> <note>
<para>Perform these commands on the controller node.</para> <para>Perform these commands on the controller node.</para>
@@ -17,8 +16,8 @@
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen> <screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen>
</step> </step>
<step> <step>
<para>List service components to verify successful launch of each <para>List service components to verify successful launch and
process:</para> registration of each process:</para>
<screen><prompt>$</prompt> <userinput>nova service-list</userinput> <screen><prompt>$</prompt> <userinput>nova service-list</userinput>
<computeroutput>+----+------------------+------------+----------+---------+-------+----------------------------+-----------------+ <computeroutput>+----+------------------+------------+----------+---------+-------+----------------------------+-----------------+
| Id | Binary | Host | Zone | Status | State | Updated_at | Disabled Reason | | Id | Binary | Host | Zone | Status | State | Updated_at | Disabled Reason |
@@ -30,18 +29,107 @@
| 5 | nova-compute | compute1 | nova | enabled | up | 2014-09-16T23:54:06.000000 | - | | 5 | nova-compute | compute1 | nova | enabled | up | 2014-09-16T23:54:06.000000 | - |
+----+------------------+------------+----------+---------+-------+----------------------------+-----------------+</computeroutput></screen> +----+------------------+------------+----------+---------+-------+----------------------------+-----------------+</computeroutput></screen>
<note> <note>
<para>This output should indicate four components enabled on the <para>This output should indicate four service components enabled on
controller node one component enabled on the compute node.</para> the controller node and one service component enabled on the
compute node.</para>
</note> </note>
</step> </step>
<step>
<para>List API endpoints in the Identity service to verify connectivity
with the Identity service:</para>
<screen><prompt>$</prompt> <userinput>nova endpoints</userinput>
<computeroutput>+-----------+------------------------------------------------------------+
| nova | Value |
+-----------+------------------------------------------------------------+
| id | 1fb997666b79463fb68db4ccfe4e6a71 |
| interface | public |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:8774/v2/ae7a98326b9c455588edd2656d723b9d |
+-----------+------------------------------------------------------------+
+-----------+------------------------------------------------------------+
| nova | Value |
+-----------+------------------------------------------------------------+
| id | bac365db1ff34f08a31d4ae98b056924 |
| interface | admin |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:8774/v2/ae7a98326b9c455588edd2656d723b9d |
+-----------+------------------------------------------------------------+
+-----------+------------------------------------------------------------+
| nova | Value |
+-----------+------------------------------------------------------------+
| id | e37186d38b8e4b81a54de34e73b43f34 |
| interface | internal |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:8774/v2/ae7a98326b9c455588edd2656d723b9d |
+-----------+------------------------------------------------------------+
+-----------+----------------------------------+
| glance | Value |
+-----------+----------------------------------+
| id | 41ad39f6c6444b7d8fd8318c18ae0043 |
| interface | admin |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:9292 |
+-----------+----------------------------------+
+-----------+----------------------------------+
| glance | Value |
+-----------+----------------------------------+
| id | 50ecc4ce62724e319f4fae3861e50f7d |
| interface | internal |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:9292 |
+-----------+----------------------------------+
+-----------+----------------------------------+
| glance | Value |
+-----------+----------------------------------+
| id | 7d3df077a20b4461a372269f603b7516 |
| interface | public |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:9292 |
+-----------+----------------------------------+
+-----------+----------------------------------+
| keystone | Value |
+-----------+----------------------------------+
| id | 88150c2fdc9d406c9b25113701248192 |
| interface | internal |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:5000/v2.0 |
+-----------+----------------------------------+
+-----------+----------------------------------+
| keystone | Value |
+-----------+----------------------------------+
| id | cecab58c0f024d95b36a4ffa3e8d81e1 |
| interface | public |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:5000/v2.0 |
+-----------+----------------------------------+
+-----------+----------------------------------+
| keystone | Value |
+-----------+----------------------------------+
| id | fc90391ae7cd4216aca070042654e424 |
| interface | admin |
| region | regionOne |
| region_id | regionOne |
| url | http://controller:35357/v2.0 |
+-----------+----------------------------------+</computeroutput></screen>
</step>
<step> <step>
<para>List images in the Image Service catalog to verify connectivity <para>List images in the Image Service catalog to verify connectivity
with the Identity service and Image Service:</para> with the Image Service:</para>
<screen><prompt>$</prompt> <userinput>nova image-list</userinput> <screen><prompt>$</prompt> <userinput>nova image-list</userinput>
<computeroutput>+--------------------------------------+---------------------+--------+--------+ <computeroutput>+--------------------------------------+---------------------+--------+--------+
| ID | Name | Status | Server | | ID | Name | Status | Server |
+--------------------------------------+---------------------+--------+--------+ +--------------------------------------+---------------------+--------+--------+
| acafc7c0-40aa-4026-9673-b879898e1fc2 | cirros-0.3.3-x86_64 | ACTIVE | | | 38047887-61a7-41ea-9b49-27987d5e8bb9 | cirros-0.3.3-x86_64 | ACTIVE | |
+--------------------------------------+---------------------+--------+--------+</computeroutput></screen> +--------------------------------------+---------------------+--------+--------+</computeroutput></screen>
</step> </step>
</procedure> </procedure>