Update installation docs

- Replace keystone_authtoken section with v3 style parameters
- Update Ubuntu doc to reference current LTS release
- Update Ubuntu doc to use systemctl

Change-Id: Ic1dedb04b08e09eda3d7772846eadeb7aa22fbb2
Closes-Bug: 1734635
This commit is contained in:
Jens Harbott 2017-11-27 14:48:11 +00:00
parent 2f75586379
commit ca7da3dcd8
6 changed files with 46 additions and 38 deletions

View File

@ -104,12 +104,14 @@ Install and configure components
.. code-block:: ini
[keystone_authtoken]
auth_host = controller
auth_port = 35357
auth_protocol = http
admin_tenant_name = service
admin_user = designate
admin_password = DESIGNATE_PASS
auth_type = password
username = designate
password = DESIGNATE_PASS
project_name = service
project_domain_name = Default
user_domain_name = Default
auth_uri = http://controller:5000/
auth_url = http://controller:5000/
Replace ``DESIGNATE_PASS`` with the password you chose for the
``designate`` user in the Identity service.

View File

@ -104,12 +104,14 @@ Install and configure components
.. code-block:: ini
[keystone_authtoken]
auth_host = controller
auth_port = 35357
auth_protocol = http
admin_tenant_name = service
admin_user = designate
admin_password = DESIGNATE_PASS
auth_type = password
username = designate
password = DESIGNATE_PASS
project_name = service
project_domain_name = Default
user_domain_name = Default
auth_uri = http://controller:5000/
auth_url = http://controller:5000/
Replace ``DESIGNATE_PASS`` with the password you chose for the
``designate`` user in the Identity service.

View File

@ -4,7 +4,7 @@ Install and configure for Ubuntu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the DNS
service for Ubuntu 14.04 (LTS).
service for Ubuntu 16.04 (LTS).
.. include:: common_prerequisites.rst
@ -74,7 +74,7 @@ Install and configure components
.. code-block:: console
# service bind9 restart
# systemctl restart bind9.service
#. Edit the ``/etc/designate/designate.conf`` file and
complete the following actions:
@ -97,12 +97,14 @@ Install and configure components
.. code-block:: ini
[keystone_authtoken]
auth_host = controller
auth_port = 35357
auth_protocol = http
admin_tenant_name = service
admin_user = designate
admin_password = DESIGNATE_PASS
auth_type = password
username = designate
password = DESIGNATE_PASS
project_name = service
project_domain_name = Default
user_domain_name = Default
auth_uri = http://controller:5000/
auth_url = http://controller:5000/
Replace ``DESIGNATE_PASS`` with the password you chose for the
``designate`` user in the Identity service.
@ -130,12 +132,14 @@ Install and configure components
# su -s /bin/sh -c "designate-manage database sync" designate
#. Restart the designate central and API services:
#. Restart the designate central and API services and configure them
to start when the system boots:
.. code-block:: console
# service designate-central restart
# service designate-api restart
# systemctl restart openstack-designate-central openstack-designate-api
# systemctl enable openstack-designate-central openstack-designate-api
#. Create a pools.yaml file in ``/etc/designate/pools.yaml`` with the following
contents:
@ -200,10 +204,11 @@ Install and configure components
# apt install designate-producer
# apt install designate-mdns
#. Restart the designate and mDNS services:
#. Start the designate and mDNS services and configure them to start when the
system boots:
.. code-block:: console
# service designate-worker restart
# service designate-producer restart
# service designate-mdns restart
# systemctl start designate-worker designate-producer designate-mdns
# systemctl enable designate-worker designate-producer designate-mdns

View File

@ -7,15 +7,14 @@ This section describes how to install and configure the
DNS service, code-named designate, on the controller node.
This section assumes that you already have a working OpenStack
environment with at least the following components installed:
Identity service, Image service, Compute service, and Networking service.
environment with at least the Identity service installed.
Note that installation and configuration vary by distribution.
.. toctree::
:maxdepth: 2
install-obs.rst
install-rdo.rst
install-ubuntu.rst
install-obs.rst

View File

@ -5,8 +5,8 @@ Next steps
Your OpenStack environment now includes the designate service.
To add additional services, see the `additional OpenStack install documentation
<http://docs.openstack.org/#install-guides>`_.
To add additional services, see the `OpenStack install guide
<https://docs.openstack.org/install-guide/>`_.
To learn more about the designate service, read the `Designate developer documentation
<https://docs.openstack.org/designate/latest/contributor/index.html>`_.

View File

@ -22,12 +22,12 @@ Verify operation of the DNS service.
$ ps -aux | grep designate
../usr/bin/python /usr/local/bin/designate-mdns --config-file /etc/designate/designate.conf
../usr/bin/python /usr/local/bin/designate-central --config-file /etc/designate/designate.conf
../usr/bin/python /usr/local/bin/designate-agent --config-file /etc/designate/designate.conf
../usr/bin/python /usr/local/bin/designate-api --config-file /etc/designate/designate.conf
../usr/bin/python /usr/local/bin/designate-worker --config-file /etc/designate/designate.conf
../usr/bin/python /usr/local/bin/designate-producer --config-file /etc/designate/designate.conf
../usr/bin/python /usr/bin/designate-mdns --config-file /etc/designate/designate.conf
../usr/bin/python /usr/bin/designate-central --config-file /etc/designate/designate.conf
../usr/bin/python /usr/bin/designate-agent --config-file /etc/designate/designate.conf
../usr/bin/python /usr/bin/designate-api --config-file /etc/designate/designate.conf
../usr/bin/python /usr/bin/designate-worker --config-file /etc/designate/designate.conf
../usr/bin/python /usr/bin/designate-producer --config-file /etc/designate/designate.conf
$ openstack dns service list
+--------------------------------------+--------------------------+--------------+--------+-------+--------------+