From fabfe1fd82a89dfb180fc3cb1b911790f8931e1d Mon Sep 17 00:00:00 2001 From: Matthew Kassawara Date: Tue, 16 Sep 2014 19:21:27 -0500 Subject: [PATCH] Update nova content for Juno 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 --- doc/install-guide/section_glance-install.xml | 5 +- .../section_keystone-install.xml | 5 +- .../section_neutron-ml2-compute-node.xml | 8 +- .../section_neutron-ml2-controller-node.xml | 11 ++- .../section_neutron-ml2-network-node.xml | 40 +++++----- .../section_nova-compute-install.xml | 25 +++++-- .../section_nova-controller-install.xml | 75 +++++++++++++++---- doc/install-guide/section_nova-verify.xml | 18 ++--- 8 files changed, 119 insertions(+), 68 deletions(-) diff --git a/doc/install-guide/section_glance-install.xml b/doc/install-guide/section_glance-install.xml index b0c924565b..b3f93260ba 100644 --- a/doc/install-guide/section_glance-install.xml +++ b/doc/install-guide/section_glance-install.xml @@ -162,9 +162,8 @@ flavor = keystone - In the [DEFAULT] section, we recommend - enabling verbose logging to assist with potential - troubleshooting: + (Optional) To assist with troubleshooting, + enable verbose logging in the [DEFAULT] section: [DEFAULT] ... verbose = True diff --git a/doc/install-guide/section_keystone-install.xml b/doc/install-guide/section_keystone-install.xml index 5cd1ef2ff8..e6e868491e 100644 --- a/doc/install-guide/section_keystone-install.xml +++ b/doc/install-guide/section_keystone-install.xml @@ -87,9 +87,8 @@ connection = mysql://keystone:KEYSTONE_DBPASS@ - In the [DEFAULT] section, we recommend - enabling verbose logging to assist with potential - troubleshooting: + (Optional) To assist with troubleshooting, + enable verbose logging in the [DEFAULT] section: [DEFAULT] ... verbose = True diff --git a/doc/install-guide/section_neutron-ml2-compute-node.xml b/doc/install-guide/section_neutron-ml2-compute-node.xml index 88a7414898..2406c22a8c 100644 --- a/doc/install-guide/section_neutron-ml2-compute-node.xml +++ b/doc/install-guide/section_neutron-ml2-compute-node.xml @@ -142,14 +142,14 @@ rabbit_password = RABBIT_PASS core_plugin = ml2 service_plugins = router allow_overlapping_ips = True - - To assist with troubleshooting, addverbose + + + (Optional) To assist with troubleshooting, addverbose = True to the [DEFAULT] section in the /etc/neutron/neutron.conf file. - - + diff --git a/doc/install-guide/section_neutron-ml2-controller-node.xml b/doc/install-guide/section_neutron-ml2-controller-node.xml index 4db462cf30..6557533245 100644 --- a/doc/install-guide/section_neutron-ml2-controller-node.xml +++ b/doc/install-guide/section_neutron-ml2-controller-node.xml @@ -224,12 +224,11 @@ nova_admin_auth_url = http://controller:35357/v2.0

- - We recommend adding verbose = True to - the [DEFAULT] section in - /etc/neutron/neutron.conf to assist with - troubleshooting. - + + + (Optional) To assist with troubleshooting, add verbose = True to + the [DEFAULT] section in + /etc/neutron/neutron.conf. diff --git a/doc/install-guide/section_neutron-ml2-network-node.xml b/doc/install-guide/section_neutron-ml2-network-node.xml index 69a3589618..be70b4e9b1 100644 --- a/doc/install-guide/section_neutron-ml2-network-node.xml +++ b/doc/install-guide/section_neutron-ml2-network-node.xml @@ -146,14 +146,14 @@ rabbit_password = RABBIT_PASS core_plugin = ml2 service_plugins = router allow_overlapping_ips = True - - To assist with troubleshooting, add verbose + + + (Optional) To assist with troubleshooting, add verbose = True to the [DEFAULT] section in the /etc/neutron/neutron.conf file. - - + @@ -169,13 +169,13 @@ allow_overlapping_ips = True ... interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver use_namespaces = True - - To assist with troubleshooting, add verbose = + + + (Optional) To assist with troubleshooting, add verbose = True to the [DEFAULT] section in the /etc/neutron/l3_agent.ini file. - - + To configure the DHCP agent @@ -191,12 +191,12 @@ use_namespaces = True interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver dhcp_driver = neutron.agent.linux.dhcp.Dnsmasq use_namespaces = True - - To assist with troubleshooting, add verbose = - True to the [DEFAULT] section - in the /etc/neutron/dhcp_agent.ini - file. - + + + (Optional) To assist with troubleshooting, add verbose = + True to the [DEFAULT] section + in the /etc/neutron/dhcp_agent.ini + file. Tunneling protocols such as @@ -274,12 +274,12 @@ admin_user = neutron admin_password = NEUTRON_PASS nova_metadata_ip = controller metadata_proxy_shared_secret = METADATA_SECRET - - To assist with troubleshooting, add verbose = - True to the [DEFAULT] section - in the /etc/neutron/metadata_agent.ini - file. - + + + (Optional) To assist with troubleshooting, add verbose = + True to the [DEFAULT] section + in the /etc/neutron/metadata_agent.ini + file. diff --git a/doc/install-guide/section_nova-compute-install.xml b/doc/install-guide/section_nova-compute-install.xml index 8a1e491fcb..d0ba04af82 100644 --- a/doc/install-guide/section_nova-compute-install.xml +++ b/doc/install-guide/section_nova-compute-install.xml @@ -52,32 +52,36 @@ rabbit_password = RABBIT_PASS RabbitMQ. - In the [keystone_authtoken] section, + In the [keystone_authtoken] section, configure Identity service access: [keystone_authtoken] ... auth_uri = http://controller:5000/v2.0 -auth_host = controller -auth_port = 35357 -auth_protocol = http +identity_uri = http://controller:35357 admin_tenant_name = service admin_user = nova admin_password = NOVA_PASS Replace NOVA_PASS with the password you chose for the nova user in the Identity service. + + Comment out any auth_host, + auth_port, and + auth_protocol options because the + identity_uri option replaces them. + In the [DEFAULT] section, configure the - my_ip key: + my_ip option: [DEFAULT] ... my_ip = MANAGEMENT_INTERFACE_IP_ADDRESS Replace MANAGEMENT_INTERFACE_IP_ADDRESS with 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 example architecture. @@ -98,7 +102,7 @@ novncproxy_base_url = http://controller:6080/vnc_auto Replace MANAGEMENT_INTERFACE_IP_ADDRESS with 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 example architecture. @@ -116,6 +120,13 @@ novncproxy_base_url = http://controller:6080/vnc_auto ... host = controller + + (Optional) To assist with troubleshooting, + enable verbose logging in the [DEFAULT] section: + [DEFAULT] +... +verbose = True + diff --git a/doc/install-guide/section_nova-controller-install.xml b/doc/install-guide/section_nova-controller-install.xml index 02c7ae2903..8d1320a9e6 100644 --- a/doc/install-guide/section_nova-controller-install.xml +++ b/doc/install-guide/section_nova-controller-install.xml @@ -21,19 +21,20 @@ Create the nova database: - mysql> CREATE DATABASE nova; + CREATE DATABASE nova; Grant proper access to the nova database: - mysql> GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' IDENTIFIED BY 'NOVA_DBPASS'; -mysql> GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' IDENTIFIED BY 'NOVA_DBPASS'; + GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' \ + IDENTIFIED BY 'NOVA_DBPASS'; +GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' \ + IDENTIFIED BY 'NOVA_DBPASS'; Replace NOVA_DBPASS with a suitable password. - Exit the database access client: - mysql> exit + Exit the database access client. @@ -48,7 +49,16 @@ Create the nova user: - $ keystone user-create --name nova --pass NOVA_PASS --email EMAIL_ADDRESS + $ keystone user-create --name nova --pass NOVA_PASS --email EMAIL_ADDRESS ++----------+----------------------------------+ +| Property | Value | ++----------+----------------------------------+ +| email | nova@example.com | +| enabled | True | +| id | 387dd4f7e46d4f72965ee99c76ae748c | +| name | nova | +| username | nova | ++----------+----------------------------------+ Replace NOVA_PASS with a suitable password and EMAIL_ADDRESS with a suitable e-mail address. @@ -58,10 +68,22 @@ service tenant and admin role: $ keystone user-role-add --user nova --tenant service --role admin + + This command provides no output. + Create the nova service: - $ keystone service-create --name nova --type compute --description "OpenStack Compute" + $ keystone service-create --name nova --type compute --description "OpenStack Compute" ++-------------+----------------------------------+ +| Property | Value | ++-------------+----------------------------------+ +| description | OpenStack Compute | +| enabled | True | +| id | 6c7854f52ce84db795557ebc0373f6b9 | +| name | nova | +| type | compute | ++-------------+----------------------------------+ @@ -71,7 +93,18 @@ --service-id $(keystone service-list | awk '/ compute / {print $2}') \ --publicurl http://controller:8774/v2/%\(tenant_id\)s \ --internalurl http://controller:8774/v2/%\(tenant_id\)s \ - --adminurl http://controller:8774/v2/%\(tenant_id\)s + --adminurl http://controller:8774/v2/%\(tenant_id\)s \ + --region regionOne ++-------------+-----------------------------------------+ +| 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 | ++-------------+-----------------------------------------+ @@ -115,23 +148,26 @@ rabbit_password = RABBIT_PASS In the [keystone_authtoken] section, configure Identity service access: - -[keystone_authtoken] + [keystone_authtoken] ... auth_uri = http://controller:5000/v2.0 -auth_host = controller -auth_port = 35357 -auth_protocol = http +identity_uri = http://controller:35357 admin_tenant_name = service admin_user = nova admin_password = NOVA_PASS Replace NOVA_PASS with the password you chose for the nova user in the Identity service. + + Comment out any auth_host, + auth_port, and + auth_protocol options because the + identity_uri option replaces them. + In the [DEFAULT] section, configure the - my_ip key to use the management interface IP + my_ip option to use the management interface IP address of the controller node: [DEFAULT] ... @@ -147,11 +183,18 @@ vncserver_listen = 10.0.0.11 vncserver_proxyclient_address = 10.0.0.11 - In the [DEFAULT] section, configure the + In the [glance] section, configure the location of the Image Service: + [glance] +... +host = controller + + + (Optional) To assist with troubleshooting, + enable verbose logging in the [DEFAULT] section: [DEFAULT] ... -glance_host = controller +verbose = True diff --git a/doc/install-guide/section_nova-verify.xml b/doc/install-guide/section_nova-verify.xml index ab79ced2fb..2c36b826eb 100644 --- a/doc/install-guide/section_nova-verify.xml +++ b/doc/install-guide/section_nova-verify.xml @@ -20,15 +20,15 @@ List service components to verify successful launch of each process: $ nova service-list -+------------------+-------------+----------+---------+-------+----------------------------+-----------------+ -| 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 | - | -+------------------+-------------+----------+---------+-------+----------------------------+-----------------+ ++----+------------------+------------+----------+---------+-------+----------------------------+-----------------+ +| Id | Binary | Host | Zone | Status | State | Updated_at | Disabled Reason | ++----+------------------+------------+----------+---------+-------+----------------------------+-----------------+ +| 1 | nova-conductor | controller | internal | enabled | up | 2014-09-16T23:54:02.000000 | - | +| 2 | nova-consoleauth | controller | internal | enabled | up | 2014-09-16T23:54:04.000000 | - | +| 3 | nova-scheduler | controller | internal | enabled | up | 2014-09-16T23:54:07.000000 | - | +| 4 | nova-cert | controller | internal | enabled | up | 2014-09-16T23:54:00.000000 | - | +| 5 | nova-compute | compute1 | nova | enabled | up | 2014-09-16T23:54:06.000000 | - | ++----+------------------+------------+----------+---------+-------+----------------------------+-----------------+ This output should indicate four components enabled on the controller node one component enabled on the compute node.