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.