diff --git a/doc/install-guide/section_cinder-controller.xml b/doc/install-guide/section_cinder-controller.xml
index c9da06a2b3..8a6860e33d 100644
--- a/doc/install-guide/section_cinder-controller.xml
+++ b/doc/install-guide/section_cinder-controller.xml
@@ -20,21 +20,21 @@
create a database and Identity service credentials including
endpoints.
- To create the database:
+ To create the database, complete these steps:
Use the database access client to connect to the database
server as the root user:
- $ mysql -u root -p
+ $ mysql -u root -p
Create the cinder database:
- mysql> CREATE DATABASE cinder;
+ CREATE DATABASE cinder;
Grant proper access to the cinder
database:
- mysql> GRANT ALL PRIVILEGES ON cinder.* TO 'cinder'@'localhost' \
+ GRANT ALL PRIVILEGES ON cinder.* TO 'cinder'@'localhost' \
IDENTIFIED BY 'CINDER_DBPASS';
mysql> GRANT ALL PRIVILEGES ON cinder.* TO 'cinder'@'%' \
IDENTIFIED BY 'CINDER_DBPASS';
@@ -42,8 +42,7 @@
a suitable password.
- Exit the database access client:
- mysql> exit
+ Exit the database access client.
@@ -53,11 +52,21 @@
$ source admin-openrc.sh
- To create the Identity service credentials:
+ To create the Identity service credentials, complete these
+ steps:
Create a cinder user:
- $ keystone user-create --name cinder --pass CINDER_PASS
+ $ keystone user-create --name cinder --pass CINDER_PASS
++----------+----------------------------------+
+| Property | Value |
++----------+----------------------------------+
+| email | |
+| enabled | True |
+| id | 881ab2de4f7941e79504a759a83308be |
+| name | cinder |
+| username | cinder |
++----------+----------------------------------+
Replace CINDER_PASS with a suitable
password.
@@ -66,28 +75,79 @@
service tenant and admin
role:
$ keystone user-role-add --user cinder --tenant service --role admin
+
+ This command provides no output.
+
-
-
-
- Create the Block Storage service (version 1 API) endpoints:
- $ keystone service-create --name cinder --type volume --description "OpenStack Block Storage"
-$ keystone endpoint-create \
+
+ Create the cinder services:
+ $ keystone service-create --name cinder --type volume \
+ --description "OpenStack Block Storage"
++-------------+----------------------------------+
+| Property | Value |
++-------------+----------------------------------+
+| description | OpenStack Block Storage |
+| enabled | True |
+| id | 1e494c3e22a24baaafcaf777d4d467eb |
+| name | cinder |
+| type | volume |
++-------------+----------------------------------+
+$ keystone service-create --name cinderv2 --type volumev2 \
+ --description "OpenStack Block Storage"
++-------------+----------------------------------+
+| Property | Value |
++-------------+----------------------------------+
+| description | OpenStack Block Storage |
+| enabled | True |
+| id | 16e038e449c94b40868277f1d801edb5 |
+| name | cinderv2 |
+| type | volumev2 |
++-------------+----------------------------------+
+
+ The Block Storage service requires two different services
+ to support API versions 1 and 2.
+
+
+
+ Create the Block Storage service endpoints:
+ $ keystone endpoint-create \
--service-id $(keystone service-list | awk '/ volume / {print $2}') \
--publicurl http://controller:8776/v1/%\(tenant_id\)s \
--internalurl http://controller:8776/v1/%\(tenant_id\)s \
--adminurl http://controller:8776/v1/%\(tenant_id\)s \
- --region regionOne
-
-
- Create the Block Storage service (version 2 API) endpoints:
- $ keystone service-create --name cinderv2 --type volumev2 --description "OpenStack Block Storage"
+ --region regionOne
++-------------+-----------------------------------------+
+| Property | Value |
++-------------+-----------------------------------------+
+| adminurl | http://controller:8776/v1/%(tenant_id)s |
+| id | d1b7291a2d794e26963b322c7f2a55a4 |
+| internalurl | http://controller:8776/v1/%(tenant_id)s |
+| publicurl | http://controller:8776/v1/%(tenant_id)s |
+| region | regionOne |
+| service_id | 1e494c3e22a24baaafcaf777d4d467eb |
++-------------+-----------------------------------------+
$ keystone endpoint-create \
--service-id $(keystone service-list | awk '/ volumev2 / {print $2}') \
--publicurl http://controller:8776/v2/%\(tenant_id\)s \
--internalurl http://controller:8776/v2/%\(tenant_id\)s \
--adminurl http://controller:8776/v2/%\(tenant_id\)s \
- --region regionOne
+ --region regionOne
++-------------+-----------------------------------------+
+| Property | Value |
++-------------+-----------------------------------------+
+| adminurl | http://controller:8776/v2/%(tenant_id)s |
+| id | 097b4a6fc8ba44b4b10d4822d2d9e076 |
+| internalurl | http://controller:8776/v2/%(tenant_id)s |
+| publicurl | http://controller:8776/v2/%(tenant_id)s |
+| region | regionOne |
+| service_id | 16e038e449c94b40868277f1d801edb5 |
++-------------+-----------------------------------------+
+
+ The Block Storage service requires two different endpoints
+ to support API versions 1 and 2.
+
+
+
@@ -193,11 +253,11 @@ verbose = True
Respond to the prompts for
database management,
Identity service
- credentials,
+ credentials,
service endpoint
- registration, and
+ registration, and
message broker
- credentials.
+ credentials.
@@ -207,31 +267,24 @@ verbose = True
# service cinder-scheduler restart
# service cinder-api restart
-
+
Start the Block Storage services and configure them to start when
the system boots:
- # systemctl enable openstack-cinder-api.service openstack-cinder-scheduler.service
+ # systemctl enable openstack-cinder-api.service openstack-cinder-scheduler.service
# systemctl start openstack-cinder-api.service openstack-cinder-scheduler.service
-
-
- Start the Block Storage services and configure them to start when
- the system boots:
- On SLES:
- # service openstack-cinder-api start
+ On SLES:
+ # service openstack-cinder-api start
# service openstack-cinder-scheduler start
# chkconfig openstack-cinder-api on
# chkconfig openstack-cinder-scheduler on
- On openSUSE:
- # systemctl enable openstack-cinder-api.service \
- openstack-cinder-scheduler.service
-# systemctl start openstack-cinder-api.service \
- openstack-cinder-scheduler.service
-
+ On openSUSE:
+ # systemctl enable openstack-cinder-api.service openstack-cinder-scheduler.service
+# systemctl start openstack-cinder-api.service openstack-cinder-scheduler.service
By default, the Ubuntu packages create an SQLite database.
- Because this configuration uses a SQL database server, remove
- the SQLite database file:
+ Because this configuration uses a SQL database server, you can
+ remove the SQLite database file:
# rm -f /var/lib/cinder/cinder.sqlite