openstack/openstack-manuals
Code Issues Proposed changes

Update nova content for Juno

Browse Source 
I updated nova content in the installation guide for Juno
as follows:

1) Removed prompts specific to MySQL because most distributions
   will use MariaDB.
2) Explicitly created endpoint with 'regionOne' region to avoid
   inconsistent defaults.
3) Replaced 'auth_*' keys with 'identity_uri' key.
4) Moved glance configuration to [glance] section.
5) Recommended enabling verbose logging.
6) Added example command output and updated existing command
   output.

Change-Id: Iad5c20e6562bcab83c6f0d5efccab566b3c18eae
This commit is contained in:
Matthew Kassawara
2014-09-16 19:21:27 -05:00
committed by Anne Gentle
parent 9991150a74
commit fabfe1fd82
8 changed files with 119 additions and 68 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
doc/install-guide/section_glance-install.xml
View File

@@ -162,9 +162,8 @@ flavor = keystone</programlisting>
</note> </note>
</step> </step>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, we recommend <para>(Optional) To assist with troubleshooting,
enabling verbose logging to assist with potential enable verbose logging in the <literal>[DEFAULT]</literal> section:</para>
troubleshooting:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
verbose = True</programlisting> verbose = True</programlisting>

5
doc/install-guide/section_keystone-install.xml
View File

@@ -87,9 +87,8 @@ connection = mysql://keystone:<replaceable>KEYSTONE_DBPASS</replaceable>@<replac
password you chose for the database.</para> password you chose for the database.</para>
</step> </step>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, we recommend <para>(Optional) To assist with troubleshooting,
enabling verbose logging to assist with potential enable verbose logging in the <literal>[DEFAULT]</literal> section:</para>
troubleshooting:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
verbose = True</programlisting> verbose = True</programlisting>

6
doc/install-guide/section_neutron-ml2-compute-node.xml
View File

@@ -142,13 +142,13 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
core_plugin = ml2 core_plugin = ml2
service_plugins = router service_plugins = router
allow_overlapping_ips = True</programlisting> allow_overlapping_ips = True</programlisting>
<note> </step>
<para>To assist with troubleshooting, add<literal>verbose <step>
<para>(Optional) To assist with troubleshooting, add<literal>verbose
= True</literal> to the <literal>[DEFAULT]</literal> = True</literal> to the <literal>[DEFAULT]</literal>
section in the section in the
<filename>/etc/neutron/neutron.conf</filename> <filename>/etc/neutron/neutron.conf</filename>
file.</para> file.</para>
</note>
</step> </step>
</substeps> </substeps>
</step> </step>

9
doc/install-guide/section_neutron-ml2-controller-node.xml
View File

@@ -224,12 +224,11 @@ nova_admin_auth_url = http://<replaceable>controller</replaceable>:35357/v2.0</p
core_plugin = ml2 core_plugin = ml2
service_plugins = router service_plugins = router
allow_overlapping_ips = True</programlisting> allow_overlapping_ips = True</programlisting>
<note> </step>
<para>We recommend adding <literal>verbose = True</literal> to <step>
<para>(Optional) To assist with troubleshooting, add <literal>verbose = True</literal> to
the <literal>[DEFAULT]</literal> section in the <literal>[DEFAULT]</literal> section in
<filename>/etc/neutron/neutron.conf</filename> to assist with <filename>/etc/neutron/neutron.conf</filename>.</para>
troubleshooting.</para>
</note>
</step> </step>
</substeps> </substeps>
</step> </step>

24
doc/install-guide/section_neutron-ml2-network-node.xml
View File

@@ -146,13 +146,13 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
core_plugin = ml2 core_plugin = ml2
service_plugins = router service_plugins = router
allow_overlapping_ips = True</programlisting> allow_overlapping_ips = True</programlisting>
<note> </step>
<para>To assist with troubleshooting, add <literal>verbose <step>
<para>(Optional) To assist with troubleshooting, add <literal>verbose
= True</literal> to the <literal>[DEFAULT]</literal> = True</literal> to the <literal>[DEFAULT]</literal>
section in the section in the
<filename>/etc/neutron/neutron.conf</filename> <filename>/etc/neutron/neutron.conf</filename>
file.</para> file.</para>
</note>
</step> </step>
</substeps> </substeps>
</step> </step>
@@ -169,12 +169,12 @@ allow_overlapping_ips = True</programlisting>
... ...
interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver
use_namespaces = True</programlisting> use_namespaces = True</programlisting>
<note> </step>
<para>To assist with troubleshooting, add <literal>verbose = <step>
<para>(Optional) To assist with troubleshooting, add <literal>verbose =
True</literal> to the <literal>[DEFAULT]</literal> section True</literal> to the <literal>[DEFAULT]</literal> section
in the <filename>/etc/neutron/l3_agent.ini</filename> in the <filename>/etc/neutron/l3_agent.ini</filename>
file.</para> file.</para>
</note>
</step> </step>
</procedure> </procedure>
<procedure> <procedure>
@@ -191,12 +191,12 @@ use_namespaces = True</programlisting>
interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver
dhcp_driver = neutron.agent.linux.dhcp.Dnsmasq dhcp_driver = neutron.agent.linux.dhcp.Dnsmasq
use_namespaces = True</programlisting> use_namespaces = True</programlisting>
<note> </step>
<para>To assist with troubleshooting, add <literal>verbose = <step>
<para>(Optional) To assist with troubleshooting, add <literal>verbose =
True</literal> to the <literal>[DEFAULT]</literal> section True</literal> to the <literal>[DEFAULT]</literal> section
in the <filename>/etc/neutron/dhcp_agent.ini</filename> in the <filename>/etc/neutron/dhcp_agent.ini</filename>
file.</para> file.</para>
</note>
</step> </step>
<step> <step>
<para>Tunneling protocols such as <para>Tunneling protocols such as
@@ -274,12 +274,12 @@ admin_user = neutron
admin_password = <replaceable>NEUTRON_PASS</replaceable> admin_password = <replaceable>NEUTRON_PASS</replaceable>
nova_metadata_ip = <replaceable>controller</replaceable> nova_metadata_ip = <replaceable>controller</replaceable>
metadata_proxy_shared_secret = <replaceable>METADATA_SECRET</replaceable></programlisting> metadata_proxy_shared_secret = <replaceable>METADATA_SECRET</replaceable></programlisting>
<note> </step>
<para>To assist with troubleshooting, add <literal>verbose = <step>
<para>(Optional) To assist with troubleshooting, add <literal>verbose =
True</literal> to the <literal>[DEFAULT]</literal> section True</literal> to the <literal>[DEFAULT]</literal> section
in the <filename>/etc/neutron/metadata_agent.ini</filename> in the <filename>/etc/neutron/metadata_agent.ini</filename>
file.</para> file.</para>
</note>
</step> </step>
<step> <step>
<note> <note>

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

@@ -52,32 +52,36 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<application>RabbitMQ</application>.</para> <application>RabbitMQ</application>.</para>
</step> </step>
<step> <step>
<para>In the <literal>[keystone_authtoken</literal>] section, <para>In the <literal>[keystone_authtoken]</literal> section,
configure Identity service access:</para> configure Identity service access:</para>
<programlisting language="ini"> <programlisting language="ini">
[keystone_authtoken] [keystone_authtoken]
... ...
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0 auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0
auth_host = <replaceable>controller</replaceable> identity_uri = http://<replaceable>controller</replaceable>:35357
auth_port = 35357
auth_protocol = http
admin_tenant_name = service admin_tenant_name = service
admin_user = nova admin_user = nova
admin_password = <replaceable>NOVA_PASS</replaceable></programlisting> admin_password = <replaceable>NOVA_PASS</replaceable></programlisting>
<para>Replace <replaceable>NOVA_PASS</replaceable> with the password <para>Replace <replaceable>NOVA_PASS</replaceable> with the password
you chose for the <literal>nova</literal> user in the Identity you chose for the <literal>nova</literal> user in the Identity
service.</para> service.</para>
<note>
<para>Comment out any <literal>auth_host</literal>,
<literal>auth_port</literal>, and
<literal>auth_protocol</literal> options because the
<literal>identity_uri</literal> option replaces them.</para>
</note>
</step> </step>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, configure the <para>In the <literal>[DEFAULT]</literal> section, configure the
<literal>my_ip</literal> key:</para> <literal>my_ip</literal> option:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
my_ip = <replaceable>MANAGEMENT_INTERFACE_IP_ADDRESS</replaceable></programlisting> my_ip = <replaceable>MANAGEMENT_INTERFACE_IP_ADDRESS</replaceable></programlisting>
<para>Replace <para>Replace
<replaceable>MANAGEMENT_INTERFACE_IP_ADDRESS</replaceable> with <replaceable>MANAGEMENT_INTERFACE_IP_ADDRESS</replaceable> with
the IP address of the management network interface on your the IP address of the management network interface on your
first compute node, typically 10.0.0.31 in the compute node, typically 10.0.0.31 for the first node in the
<link linkend="architecture_example-architectures">example <link linkend="architecture_example-architectures">example
architecture</link>.</para> architecture</link>.</para>
</step> </step>
@@ -98,7 +102,7 @@ novncproxy_base_url = http://<replaceable>controller</replaceable>:6080/vnc_auto
<para>Replace <para>Replace
<replaceable>MANAGEMENT_INTERFACE_IP_ADDRESS</replaceable> with <replaceable>MANAGEMENT_INTERFACE_IP_ADDRESS</replaceable> with
the IP address of the management network interface on your the IP address of the management network interface on your
first compute node, typically 10.0.0.31 in the compute node, typically 10.0.0.31 for the first node in the
<link linkend="architecture_example-architectures">example <link linkend="architecture_example-architectures">example
architecture</link>.</para> architecture</link>.</para>
<note> <note>
@@ -116,6 +120,13 @@ novncproxy_base_url = http://<replaceable>controller</replaceable>:6080/vnc_auto
... ...
host = <replaceable>controller</replaceable></programlisting> host = <replaceable>controller</replaceable></programlisting>
</step> </step>
<step>
<para>(Optional) To assist with troubleshooting,
enable verbose logging in the <literal>[DEFAULT]</literal> section:</para>
<programlisting language="ini">[DEFAULT]
...
verbose = True</programlisting>
</step>
</substeps> </substeps>
</step> </step>
</procedure> </procedure>

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

@@ -21,19 +21,20 @@
</step> </step>
<step> <step>
<para>Create the <literal>nova</literal> database:</para> <para>Create the <literal>nova</literal> database:</para>
<screen><prompt>mysql></prompt> <userinput>CREATE DATABASE nova;</userinput></screen> <screen><userinput>CREATE DATABASE nova;</userinput></screen>
</step> </step>
<step> <step>
<para>Grant proper access to the <literal>nova</literal> <para>Grant proper access to the <literal>nova</literal>
database:</para> database:</para>
<screen><prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput> <screen><userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' \
<prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput></screen> IDENTIFIED BY '<replaceable>NOVA_DBPASS</replaceable>';</userinput>
<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 <para>Replace <replaceable>NOVA_DBPASS</replaceable> with a suitable
password.</para> password.</para>
</step> </step>
<step> <step>
<para>Exit the database access client:</para> <para>Exit the database access client.</para>
<screen><prompt>mysql></prompt> <userinput>exit</userinput></screen>
</step> </step>
</substeps> </substeps>
</step> </step>
@@ -48,7 +49,16 @@
<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> --email <replaceable>EMAIL_ADDRESS</replaceable></userinput></screen> <screen><prompt>$</prompt> <userinput>keystone user-create --name nova --pass <replaceable>NOVA_PASS</replaceable> --email <replaceable>EMAIL_ADDRESS</replaceable></userinput>
<computeroutput>+----------+----------------------------------+
| Property | Value |
+----------+----------------------------------+
| email | nova@example.com |
| enabled | True |
| id | 387dd4f7e46d4f72965ee99c76ae748c |
| name | nova |
| username | nova |
+----------+----------------------------------+</computeroutput></screen>
<para>Replace <replaceable>NOVA_PASS</replaceable> with a suitable <para>Replace <replaceable>NOVA_PASS</replaceable> with a suitable
password and <replaceable>EMAIL_ADDRESS</replaceable> with password and <replaceable>EMAIL_ADDRESS</replaceable> with
a suitable e-mail address.</para> a suitable e-mail address.</para>
@@ -58,10 +68,22 @@
<literal>service</literal> tenant and <literal>admin</literal> <literal>service</literal> tenant and <literal>admin</literal>
role:</para> role:</para>
<screen><prompt>$</prompt> <userinput>keystone user-role-add --user nova --tenant service --role admin</userinput></screen> <screen><prompt>$</prompt> <userinput>keystone user-role-add --user nova --tenant service --role admin</userinput></screen>
<note>
<para>This command provides no output.</para>
</note>
</step> </step>
<step> <step>
<para>Create the <literal>nova</literal> service:</para> <para>Create the <literal>nova</literal> service:</para>
<screen><prompt>$</prompt> <userinput>keystone service-create --name nova --type compute --description "OpenStack Compute"</userinput></screen> <screen><prompt>$</prompt> <userinput>keystone service-create --name nova --type compute --description "OpenStack Compute"</userinput>
<computeroutput>+-------------+----------------------------------+
| Property | Value |
+-------------+----------------------------------+
| description | OpenStack Compute |
| enabled | True |
| id | 6c7854f52ce84db795557ebc0373f6b9 |
| name | nova |
| type | compute |
+-------------+----------------------------------+</computeroutput></screen>
</step> </step>
</substeps> </substeps>
</step> </step>
@@ -71,7 +93,18 @@
--service-id $(keystone service-list | awk '/ compute / {print $2}') \ --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</userinput></screen> --adminurl http://<replaceable>controller</replaceable>:8774/v2/%\(tenant_id\)s \
--region regionOne</userinput>
<computeroutput>+-------------+-----------------------------------------+
| Property | Value |
+-------------+-----------------------------------------+
| adminurl | http://controller:8774/v2/%(tenant_id)s |
| id | c397438bd82c41198ec1a9d85cb7cc74 |
| internalurl | http://controller:8774/v2/%(tenant_id)s |
| publicurl | http://controller:8774/v2/%(tenant_id)s |
| region | regionOne |
| service_id | 6c7854f52ce84db795557ebc0373f6b9 |
+-------------+-----------------------------------------+</computeroutput></screen>
</step> </step>
</procedure> </procedure>
<procedure os="ubuntu;rhel;centos;fedora;sles;opensuse"> <procedure os="ubuntu;rhel;centos;fedora;sles;opensuse">
@@ -115,23 +148,26 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<step> <step>
<para>In the <literal>[keystone_authtoken]</literal> section, <para>In the <literal>[keystone_authtoken]</literal> section,
configure Identity service access:</para> configure Identity service access:</para>
<programlisting language="ini"> <programlisting language="ini">[keystone_authtoken]
[keystone_authtoken]
... ...
auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0 auth_uri = http://<replaceable>controller</replaceable>:5000/v2.0
auth_host = <replaceable>controller</replaceable> identity_uri = http://<replaceable>controller</replaceable>:35357
auth_port = 35357
auth_protocol = http
admin_tenant_name = service admin_tenant_name = service
admin_user = nova admin_user = nova
admin_password = <replaceable>NOVA_PASS</replaceable></programlisting> admin_password = <replaceable>NOVA_PASS</replaceable></programlisting>
<para>Replace <replaceable>NOVA_PASS</replaceable> with the password <para>Replace <replaceable>NOVA_PASS</replaceable> with the password
you chose for the <literal>nova</literal> user in the Identity you chose for the <literal>nova</literal> user in the Identity
service.</para> service.</para>
<note>
<para>Comment out any <literal>auth_host</literal>,
<literal>auth_port</literal>, and
<literal>auth_protocol</literal> options because the
<literal>identity_uri</literal> option replaces them.</para>
</note>
</step> </step>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, configure the <para>In the <literal>[DEFAULT]</literal> section, configure the
<literal>my_ip</literal> key to use the management interface IP <literal>my_ip</literal> option to use the management interface IP
address of the controller node:</para> address of the controller node:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
@@ -147,11 +183,18 @@ vncserver_listen = 10.0.0.11
vncserver_proxyclient_address = 10.0.0.11</programlisting> vncserver_proxyclient_address = 10.0.0.11</programlisting>
</step> </step>
<step> <step>
<para>In the <literal>[DEFAULT]</literal> section, configure the <para>In the <literal>[glance]</literal> section, configure the
location of the Image Service:</para> location of the Image Service:</para>
<programlisting language="ini">[glance]
...
host = <replaceable>controller</replaceable></programlisting>
</step>
<step>
<para>(Optional) To assist with troubleshooting,
enable verbose logging in the <literal>[DEFAULT]</literal> section:</para>
<programlisting language="ini">[DEFAULT] <programlisting language="ini">[DEFAULT]
... ...
glance_host = <replaceable>controller</replaceable></programlisting> verbose = True</programlisting>
</step> </step>
</substeps> </substeps>
</step> </step>

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

@@ -20,15 +20,15 @@
<para>List service components to verify successful launch of each <para>List service components to verify successful launch of each
process:</para> process:</para>
<screen><prompt>$</prompt> <userinput>nova service-list</userinput> <screen><prompt>$</prompt> <userinput>nova service-list</userinput>
<computeroutput>+------------------+-------------+----------+---------+-------+----------------------------+-----------------+ <computeroutput>+----+------------------+------------+----------+---------+-------+----------------------------+-----------------+
| Binary | Host | Zone | Status | State | Updated_at | Disabled Reason | | Id | Binary | Host | Zone | Status | State | Updated_at | Disabled Reason |
+------------------+-------------+----------+---------+-------+----------------------------+-----------------+ +----+------------------+------------+----------+---------+-------+----------------------------+-----------------+
| nova-cert | controller | internal | enabled | up | 2014-06-29T22:23:16.000000 | - | | 1 | nova-conductor | controller | internal | enabled | up | 2014-09-16T23:54:02.000000 | - |
| nova-consoleauth | controller | internal | enabled | up | 2014-06-29T22:23:10.000000 | - | | 2 | nova-consoleauth | controller | internal | enabled | up | 2014-09-16T23:54:04.000000 | - |
| nova-scheduler | controller | internal | enabled | up | 2014-06-29T22:23:14.000000 | - | | 3 | nova-scheduler | controller | internal | enabled | up | 2014-09-16T23:54:07.000000 | - |
| nova-conductor | controller | internal | enabled | up | 2014-06-29T22:23:11.000000 | - | | 4 | nova-cert | controller | internal | enabled | up | 2014-09-16T23:54:00.000000 | - |
| nova-compute | compute1 | nova | enabled | up | 2014-06-29T22:23:11.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 components enabled on the
controller node one component enabled on the compute node.</para> controller node one component enabled on the compute node.</para>