diff --git a/doc/source/install/index.rst b/doc/source/install/index.rst index 504bf217e..3d7bfed25 100644 --- a/doc/source/install/index.rst +++ b/doc/source/install/index.rst @@ -133,7 +133,6 @@ placement with the rest of an OpenStack cloud. :maxdepth: 1 from-pypi.rst - install-obs.rst install-rdo.rst install-ubuntu.rst verify.rst diff --git a/doc/source/install/install-obs.rst b/doc/source/install/install-obs.rst deleted file mode 100644 index c186cf18a..000000000 --- a/doc/source/install/install-obs.rst +++ /dev/null @@ -1,137 +0,0 @@ -Install and configure Placement for openSUSE and SUSE Linux Enterprise -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -This section describes how to install and configure the placement service -when using openSUSE or SUSE Linux Enterprise packages. - -Prerequisites -------------- - -Before you install and configure the placement service, you must create -a database, service credentials, and API endpoints. - -Create Database -^^^^^^^^^^^^^^^ - -#. To create the database, complete these steps: - - * Use the database access client to connect to the database server - as the ``root`` user: - - .. code-block:: console - - $ mysql -u root -p - - * Create the ``placement`` database: - - .. code-block:: console - - MariaDB [(none)]> CREATE DATABASE placement; - - * Grant proper access to the database: - - .. code-block:: console - - MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'localhost' \ - IDENTIFIED BY 'PLACEMENT_DBPASS'; - MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'%' \ - IDENTIFIED BY 'PLACEMENT_DBPASS'; - - Replace ``PLACEMENT_DBPASS`` with a suitable password. - - * Exit the database access client. - -Configure User and Endpoints -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. include:: shared/endpoints.rst - -Install and configure components --------------------------------- - -.. include:: note_configuration_vary_by_distribution.rst - -.. note:: - - As of the Newton release, SUSE OpenStack packages are shipped with the - upstream default configuration files. For example, - ``/etc/placement/placement.conf`` has customizations in - ``/etc/placement/placement.conf.d/010-placement.conf``. While the following - instructions modify the default configuration file, adding a new file in - ``/etc/placement/placement.conf.d`` achieves the same result. - -#. Install the packages: - - .. code-block:: console - - # zypper install openstack-placement - -#. Edit the ``/etc/placement/placement.conf`` file and complete the following - actions: - - * In the ``[placement_database]`` section, configure database access: - - .. path /etc/placement/placement.conf - .. code-block:: ini - - [placement_database] - # ... - connection = mysql+pymysql://placement:PLACEMENT_DBPASS@controller/placement - - Replace ``PLACEMENT_DBPASS`` with the password you chose for the - placement database. - - * In the ``[api]`` and ``[keystone_authtoken]`` sections, configure Identity - service access: - - .. path /etc/placement/placement.conf - .. code-block:: ini - - [api] - # ... - auth_strategy = keystone - - [keystone_authtoken] - # ... - auth_url = http://controller:5000/v3 - memcached_servers = controller:11211 - auth_type = password - project_domain_name = Default - user_domain_name = Default - project_name = service - username = placement - password = PLACEMENT_PASS - - Replace ``PLACEMENT_PASS`` with the password you chose for the - ``placement`` user in the Identity service. - - .. note:: - - Comment out or remove any other options in the ``[keystone_authtoken]`` - section. - - .. note:: - - The value of ``user_name``, ``password``, ``project_domain_name`` and - ``user_domain_name`` need to be in sync with your keystone config. - -#. Populate the ``placement`` database: - - .. code-block:: console - - # su -s /bin/sh -c "placement-manage db sync" placement - - .. note:: - - Ignore any deprecation messages in this output. - -Finalize installation ---------------------- - -* Enable the placement API Apache vhost: - - .. code-block:: console - - # mv /etc/apache2/vhosts.d/openstack-placement-api.conf.sample \ - /etc/apache2/vhosts.d/openstack-placement-api.conf - # systemctl reload apache2.service