From 68db779d0e8029e1311a8a6be300e45be6902270 Mon Sep 17 00:00:00 2001 From: Matthew Kassawara Date: Fri, 27 Mar 2015 07:40:59 -0500 Subject: [PATCH] Modify nova content for Kilo 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 --- .../section_nova-compute-install.xml | 22 +++- .../section_nova-controller-install.xml | 101 +++++++++-------- doc/install-guide/section_nova-verify.xml | 104 ++++++++++++++++-- 3 files changed, 171 insertions(+), 56 deletions(-) diff --git a/doc/install-guide/section_nova-compute-install.xml b/doc/install-guide/section_nova-compute-install.xml index 25bcc8cb7f..84614846e5 100644 --- a/doc/install-guide/section_nova-compute-install.xml +++ b/doc/install-guide/section_nova-compute-install.xml @@ -38,6 +38,13 @@ To install and configure the Compute hypervisor components + + 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. + Install the packages: # apt-get install nova-compute sysfsutils @@ -49,15 +56,20 @@ complete the following actions: - In the [DEFAULT] section, configure - RabbitMQ message broker access: + In the [DEFAULT] and + [oslo_messaging_rabbit] sections, configure + RabbitMQ message queue access: [DEFAULT] ... rpc_backend = rabbit + +[oslo_messaging_rabbit] +... rabbit_host = controller +rabbit_userid = openstack rabbit_password = RABBIT_PASS Replace RABBIT_PASS with the password - you chose for the guest account in + you chose for the openstack account in RabbitMQ. @@ -70,7 +82,7 @@ auth_strategy = keystone [keystone_authtoken] ... -auth_uri = http://controller:5000/v2.0 +auth_uri = http://controller:5000 identity_uri = http://controller:35357 admin_tenant_name = service admin_user = nova @@ -173,7 +185,7 @@ verbose = True credentials, service endpoint registration, and - message broker + message queue credentials.. diff --git a/doc/install-guide/section_nova-controller-install.xml b/doc/install-guide/section_nova-controller-install.xml index cbefdb622a..56ed474f78 100644 --- a/doc/install-guide/section_nova-controller-install.xml +++ b/doc/install-guide/section_nova-controller-install.xml @@ -50,67 +50,77 @@ Create the nova user: -$ keystone user-create --name nova --pass NOVA_PASS -+----------+----------------------------------+ -| Property | Value | +$ openstack user create --password-prompt nova +User Password: +Repeat User Password: +----------+----------------------------------+ -| email | | -| enabled | True | -| id | 387dd4f7e46d4f72965ee99c76ae748c | -| name | nova | -| username | nova | +| Field | Value | +----------+----------------------------------+ - - Replace NOVA_PASS with - a suitable password. +| email | None | +| enabled | True | +| id | 8e0b71d732db4bfba04943a96230c8c0 | +| name | nova | +| username | nova | ++----------+----------------------------------+ Add the admin role to the nova user: -$ keystone user-role-add --user nova --tenant service --role admin - - This command provides no output. - +$ openstack role add --project service --user nova admin ++-------+----------------------------------+ +| Field | Value | ++-------+----------------------------------+ +| id | 1169d778631b4fd1aefd9d35314e1c56 | +| name | admin | ++-------+----------------------------------+ Create the nova service entity: -$ keystone service-create --name nova --type compute \ - --description "OpenStack Compute" +$ openstack service create --type compute \ + --description "OpenStack Compute" nova +-------------+----------------------------------+ -| Property | Value | +| Field | Value | +-------------+----------------------------------+ -| description | OpenStack Compute | -| enabled | True | -| id | 6c7854f52ce84db795557ebc0373f6b9 | -| name | nova | -| type | compute | -+-------------+----------------------------------+ - +| description | OpenStack Compute | +| enabled | True | +| id | 060d59eac51b4594815603d75a00aba2 | +| name | nova | +| type | compute | ++-------------+----------------------------------+ Create the Compute service API endpoints: - $ keystone endpoint-create \ - --service-id $(keystone service-list | awk '/ compute / {print $2}') \ + $ openstack endpoint create --publicurl http://controller:8774/v2/%\(tenant_id\)s \ --internalurl 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 | -+-------------+-----------------------------------------+ + --region regionOne + compute ++--------------+------------------------------------------+ +| Field | Value | ++--------------+------------------------------------------+ +| adminurl | http://msk-os4ctl1:8774/v2/%(tenant_id)s | +| id | 4e885d4ad43f4c4fbf2287734bc58d6b | +| internalurl | http://msk-os4ctl1:8774/v2/%(tenant_id)s | +| publicurl | http://msk-os4ctl1:8774/v2/%(tenant_id)s | +| region | regionOne | +| service_id | 060d59eac51b4594815603d75a00aba2 | +| service_name | nova | +| service_type | compute | ++--------------+------------------------------------------+ To install and configure Compute controller components + + 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. + Install the packages: # apt-get install nova-api nova-cert nova-conductor nova-consoleauth \ @@ -136,15 +146,20 @@ connection = mysql://nova:NOVA_DBPASS@controller/nova password you chose for the Compute database. - In the [DEFAULT] section, configure - RabbitMQ message broker access: + In the [DEFAULT] and + [oslo_messaging_rabbit] sections, configure + RabbitMQ message queue access: [DEFAULT] ... rpc_backend = rabbit + +[oslo_messaging_rabbit] +... rabbit_host = controller +rabbit_userid = openstack rabbit_password = RABBIT_PASS Replace RABBIT_PASS with the - password you chose for the guest account in + password you chose for the openstack account in RabbitMQ. @@ -157,7 +172,7 @@ auth_strategy = keystone [keystone_authtoken] ... -auth_uri = http://controller:5000/v2.0 +auth_uri = http://controller:5000 identity_uri = http://controller:35357 admin_tenant_name = service admin_user = nova @@ -224,7 +239,7 @@ verbose = True credentials, service endpoint registration, and - message broker + message queue credentials. diff --git a/doc/install-guide/section_nova-verify.xml b/doc/install-guide/section_nova-verify.xml index 2c36b826eb..be09d3b16e 100644 --- a/doc/install-guide/section_nova-verify.xml +++ b/doc/install-guide/section_nova-verify.xml @@ -5,8 +5,7 @@ version="5.0" xml:id="nova-verify"> Verify operation - This section describes how to verify operation of the Compute - service. + Verify operation of the Compute service. Perform these commands on the controller node. @@ -17,8 +16,8 @@ $ source admin-openrc.sh - List service components to verify successful launch of each - process: + List service components to verify successful launch and + registration of each process: $ nova service-list +----+------------------+------------+----------+---------+-------+----------------------------+-----------------+ | 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 | - | +----+------------------+------------+----------+---------+-------+----------------------------+-----------------+ - This output should indicate four components enabled on the - controller node one component enabled on the compute node. + This output should indicate four service components enabled on + the controller node and one service component enabled on the + compute node. + + List API endpoints in the Identity service to verify connectivity + with the Identity service: + $ nova endpoints ++-----------+------------------------------------------------------------+ +| 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 | ++-----------+----------------------------------+ + List images in the Image Service catalog to verify connectivity - with the Identity service and Image Service: + with the Image Service: $ nova image-list +--------------------------------------+---------------------+--------+--------+ | 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 | | +--------------------------------------+---------------------+--------+--------+