diff --git a/doc/install-guide/section_debconf-api-endpoints.xml b/doc/install-guide/section_debconf-api-endpoints.xml
index 1cbd126e93..548d78b086 100644
--- a/doc/install-guide/section_debconf-api-endpoints.xml
+++ b/doc/install-guide/section_debconf-api-endpoints.xml
@@ -82,4 +82,21 @@
+ The Debian package post installation scripts will then perform the
+ below commands for you:
+ PKG_SERVICE_ID=$(pkgos_get_id keystone --os-token ${AUTH_TOKEN} \
+ --os-endpoint http://${KEYSTONE_ENDPOINT_IP}:35357/v2.0/ service-create \
+ --name=${SERVICE_NAME} --type=${SERVICE_TYPE} --description="${SERVICE_DESC}")
+keystone --os-token ${AUTH_TOKEN} \
+ --os-endpoint http://${KEYSTONE_ENDPOINT_IP}:35357/v2.0/
+ endpoint-create \
+ --region "${REGION_NAME}" --service_id=${PKG_SERVICE_ID} \
+ --publicurl=http://${PKG_ENDPOINT_IP}:${SERVICE_PORT}${SERVICE_URL} \
+ --internalurl=http://${PKG_ENDPOINT_IP}:${SERVICE_PORT}${SERVICE_URL} \
+ --adminurl=http://${PKG_ENDPOINT_IP}:${SERVICE_PORT}${SERVICE_URL})
+ The values of AUTH_TOKEN, KEYSTONE_ENDPOINT_IP,
+ PKG_ENDPOINT_IP and REGION_NAME depend on the
+ answer you will provide to the debconf prompts. But the values of SERVICE_NAME,
+ SERVICE_TYPE, SERVICE_DESC and SERVICE_URL
+ are already pre-wired in each package, so you don't have to remember them.
diff --git a/doc/install-guide/section_debconf-dbconfig-common.xml b/doc/install-guide/section_debconf-dbconfig-common.xml
index 12ad30b19f..16b6ade34f 100644
--- a/doc/install-guide/section_debconf-dbconfig-common.xml
+++ b/doc/install-guide/section_debconf-dbconfig-common.xml
@@ -4,16 +4,22 @@
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
Configure the database with dbconfig-common
- The dbconfig-common package provides a
- standard Debian interface that enables you to configure Debian
+ Many of the OpenStack services need to be configured
+ to access a database. These are configured through a DSN (Database
+ Source Name) directive as follows:
+ [database]
+connection = mysql://keystone:0dec658e3f14a7d@localhost/keystonedb
+ This connection directive will be handled by
+ the dbconfig-common package, which provides a
+ standard Debian interface. It enables you to configure Debian
database parameters. It includes localized prompts for many
- languages and it supports the OpenStack database back ends:
+ languages and it supports the following database backends:
SQLite, MySQL, and PostgreSQL.
By default, the dbconfig-common package
- configures the OpenStack services to use SQLite3. So if you use
- debconf in non-interactive mode and without
- pre-seeding, the OpenStack services that you install use
- SQLite3.
+ configures the OpenStack services to use SQLite. So if you use
+ debconf in non-interactive mode and without
+ pre-seeding, the OpenStack services that you install will use
+ SQLite.
By default, dbconfig-common does not
provide access to database servers over a network. If you want the
dbconfig-common package to prompt for remote
@@ -54,7 +60,7 @@ dbc_upgrade='true'
dbc_remove=''
dbc_dbtype='mysql'
dbc_dbuser='keystone'
-dbc_dbpass='MyKeyStoneDbPassWord'
+dbc_dbpass='PASSWORD'
dbc_dbserver=''
dbc_dbport=''
dbc_dbname='keystonedb'
@@ -67,9 +73,20 @@ dbc_authmethod_user=''
# apt-get install keystone
The Identity Service is installed with MySQL as the database
back end, keystonedb as database name, and the
- localhost socket file.
- The cinder-common package displays these
- screens:
+ localhost socket file. The corresponding DNS will then be:
+ [database]
+connection = mysql://keystone:PASSWORD@localhost/keystonedb
+ The dbconfig-common package will configure
+ MySQL for these access rights, and create the database for you.
+ Since OpenStack 2014.1.1, all OpenStack packages in Debian are performing
+ the following MySQL query after database creation (if you decide
+ to use MySQL as a back-end):
+ ALTER DATABASE keystone CHARACTER SET utf8 COLLATE utf8_unicode_ci
+ So, if using Debian, you wont need to care about database
+ creation, access rights and character sets. All that is handled
+ for you by the packages.
+ As an example, here are screenshots from the
+ cinder-common package:
diff --git a/doc/install-guide/section_debconf-rabbitmq.xml b/doc/install-guide/section_debconf-rabbitmq.xml
index 9b3b444269..8cf0f77c3b 100644
--- a/doc/install-guide/section_debconf-rabbitmq.xml
+++ b/doc/install-guide/section_debconf-rabbitmq.xml
@@ -37,4 +37,11 @@
>heat-common, neutron-common and nova-common.
+ This will configure the below directives (example from
+ nova.conf):
+ [DEFAULT]
+rabbit_host=localhost
+rabbit_userid=guest
+rabbit_password=guest
+ The other directives concerning RabbitMQ will stay untouched.