diff --git a/doc/install-guide/figures/debconf-screenshots/glance-common_pipeline_flavor.png b/doc/install-guide/figures/debconf-screenshots/glance-common_pipeline_flavor.png
new file mode 100644
index 0000000000..488b74ed35
Binary files /dev/null and b/doc/install-guide/figures/debconf-screenshots/glance-common_pipeline_flavor.png differ
diff --git a/doc/install-guide/section_glance-install.xml b/doc/install-guide/section_glance-install.xml
index b0071774c5..f84500d290 100644
--- a/doc/install-guide/section_glance-install.xml
+++ b/doc/install-guide/section_glance-install.xml
@@ -24,7 +24,18 @@
# yum install openstack-glance
# zypper install openstack-glance python-glanceclient
- The Image
+ Answer to the debconf prompts to setup the
+ database, register the Image service into the Identity service
+ catalogue (API endpoint), configure the keystone_authtoken,
+ and the RabbitMQ credentials. You will also have to select the type
+ of caching as per the screenshot below:
+
+
+
+
+
+
+ The Image
Service stores information about images in a database. This
guide uses the MySQL database that is used by other OpenStack
services.
@@ -60,20 +71,7 @@ sql_connection = mysql://glance:GLANCE_DBPASS@localhost/glance
called glance to connect to the database.
# openstack-db --init --service glance --password GLANCE_DBPASS
-
- Note for Debian users
- As for the rest of OpenStack, the Image Service is configured through
- debconf. So you will not need to manually configure the database, do the
- glance-manage db_sync manually, configure the Keystone auth token, or
- the RabbitMQ parameters of Glance. Therefore, all the below steps can be
- skipped. If you need to reconfigure the Image Service, you can use:
- # dpkg-reconfigure -plow glance-common
- or edit the configuration files and manually restart the daemons.
- Remember that if your database server is installed remotely, before
- installing the Image Service, you will need to do:
- # apt-get install dbconfig-common && \
- dpkg-reconfigure -plow dbconfig-common
-
+
The Ubuntu packages create an sqlite database by
default. Delete the glance.sqlite file created in
the /var/lib/glance/ directory so it is not used by mistake.
@@ -87,12 +85,12 @@ IDENTIFIED BY 'GLANCE_DBPASS';
IDENTIFIED BY 'GLANCE_DBPASS';
-
+
We now create the database tables for the Image service.
# glance-manage db_sync
- Create a user called glance that the Image
+ Create a user called glance that the Image
Service can use to authenticate with the Identity Service. Choose a
password for the glance user and specify an email
address for the account. Use the
@@ -100,7 +98,7 @@ IDENTIFIED BY 'GLANCE_DBPASS';
admin role.
# keystone user-create --name=glance --pass=GLANCE_PASS --email=glance@example.com
# keystone user-role-add --user=glance --tenant=service --role=admin
- Add the credentials to the Image Service's configuration files.
+ Add the credentials to the Image Service's configuration files.
# openstack-config --set /etc/glance/glance-api.conf keystone_authtoken auth_host controller
# openstack-config --set /etc/glance/glance-api.conf keystone_authtoken admin_user glance
@@ -110,9 +108,9 @@ IDENTIFIED BY 'GLANCE_DBPASS';
# openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken admin_user glance
# openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken admin_tenant_name service
# openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken admin_password GLANCE_PASS
- Edit /etc/glance/glance-api.conf and /etc/glance/glance-registry.conf
+ Edit /etc/glance/glance-api.conf and /etc/glance/glance-registry.conf
and change the [keystone_authtoken] section.
-
+
...
[keystone_authtoken]
auth_host = controller
@@ -128,7 +126,7 @@ admin_password = GLANCE_PASS
host name in the credentials.
-
+
You also have to add the credentials to the files
/etc/glance/glance-api-paste.ini and
/etc/glance/glance-registry-paste.ini.
@@ -150,12 +148,12 @@ admin_tenant_name=service
admin_password=GLANCE_PASS
- Register the Image Service with the Identity Service
+ Register the Image Service with the Identity Service
so that other OpenStack services can locate it. Register the service and
specify the endpoint using the keystone command.
# keystone service-create --name=glance --type=image \
--description="Glance Image Service"
- Note the service's id property returned in the previous step and use it when
+ Note the service's id property returned in the previous step and use it when
creating the endpoint.
# keystone endpoint-create \
--service-id=the_service_id_above \
@@ -163,7 +161,7 @@ admin_password=GLANCE_PASS
--internalurl=http://controller:9292 \
--adminurl=http://controller:9292
-
+
We now restart the glance service with its new settings.
# service glance-registry restart
# service glance-api restart