diff --git a/doc/install-guide/source/environment-memcached-debian.rst b/doc/install-guide/source/environment-memcached-debian.rst deleted file mode 100644 index 69fb0ca2f8..0000000000 --- a/doc/install-guide/source/environment-memcached-debian.rst +++ /dev/null @@ -1,54 +0,0 @@ -Debian Memcached -~~~~~~~~~~~~~~~~ - -The Identity service authentication mechanism for services uses Memcached -to cache tokens. The memcached service typically runs on the controller -node. For production deployments, we recommend enabling a combination of -firewalling, authentication, and encryption to secure it. - -Install and configure components --------------------------------- - -#. Install the packages: - - -.. code-block:: console - - # apt install memcached python-memcache - -.. end - - - - - -2. Edit the ``/etc/memcached.conf`` file and configure the - service to use the management IP address of the controller node. - This is to enable access by other nodes via the management network: - - .. code-block:: none - - -l 10.0.0.11 - - .. end - - .. note:: - - Change the existing line that had ``-l 127.0.0.1``. - - - - -Finalize installation ---------------------- - - -* Restart the Memcached service: - - .. code-block:: console - - # service memcached restart - - .. end - - diff --git a/doc/install-guide/source/environment-messaging-debian.rst b/doc/install-guide/source/environment-messaging-debian.rst deleted file mode 100644 index f8a797601f..0000000000 --- a/doc/install-guide/source/environment-messaging-debian.rst +++ /dev/null @@ -1,56 +0,0 @@ -Debian Message queue -~~~~~~~~~~~~~~~~~~~~ - -OpenStack uses a :term:`message queue` to coordinate operations and -status information among services. The message queue service typically -runs on the controller node. OpenStack supports several message queue -services including `RabbitMQ `__, -`Qpid `__, and `ZeroMQ `__. -However, most distributions that package OpenStack support a particular -message queue service. This guide implements the RabbitMQ message queue -service because most distributions support it. If you prefer to -implement a different message queue service, consult the documentation -associated with it. - -The message queue runs on the controller node. - -Install and configure components --------------------------------- - -1. Install the package: - - -.. code-block:: console - - # apt install rabbitmq-server - -.. end - - - - - - -2. Add the ``openstack`` user: - - .. code-block:: console - - # rabbitmqctl add_user openstack RABBIT_PASS - - Creating user "openstack" ... - - .. end - - Replace ``RABBIT_PASS`` with a suitable password. - -3. Permit configuration, write, and read access for the - ``openstack`` user: - - .. code-block:: console - - # rabbitmqctl set_permissions openstack ".*" ".*" ".*" - - Setting permissions for user "openstack" in vhost "/" ... - - .. end - diff --git a/doc/install-guide/source/environment-packages-debian.rst b/doc/install-guide/source/environment-packages-debian.rst deleted file mode 100644 index fd1d453892..0000000000 --- a/doc/install-guide/source/environment-packages-debian.rst +++ /dev/null @@ -1,88 +0,0 @@ -Debian OpenStack packages -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Distributions release OpenStack packages as part of the distribution or -using other methods because of differing release schedules. Perform -these procedures on all nodes. - -.. note:: - - The set up of OpenStack packages described here needs to be done on - all nodes: controller, compute, and Block Storage nodes. - -.. warning:: - - Your hosts must contain the latest versions of base installation - packages available for your distribution before proceeding further. - -.. note:: - - Disable or remove any automatic update services because they can - impact your OpenStack environment. - - - - - -Enable the backports repository -------------------------------- - -The Newton release is available directly through the official -Debian backports repository. To use this repository, follow -the instruction from the official -`Debian website `_, -which basically suggest doing the following steps: - -#. On all nodes, adding the Debian 8 (Jessie) backport repository to - the source list: - - .. code-block:: console - - # echo "deb http://http.debian.net/debian jessie-backports main" \ - >>/etc/apt/sources.list - - .. end - - .. note:: - - Later you can use the following command to install a package: - - .. code-block:: console - - # apt -t jessie-backports install ``PACKAGE`` - - .. end - - -Finalize the installation -------------------------- - -1. Upgrade the packages on all nodes: - - -.. code-block:: console - - # apt update && apt dist-upgrade - -.. end - - - - - .. note:: - - If the upgrade process includes a new kernel, reboot your host - to activate it. - -2. Install the OpenStack client: - - -.. code-block:: console - - # apt install python-openstackclient - -.. end - - - - diff --git a/doc/install-guide/source/environment-sql-database-debian.rst b/doc/install-guide/source/environment-sql-database-debian.rst deleted file mode 100644 index 1dec4a2156..0000000000 --- a/doc/install-guide/source/environment-sql-database-debian.rst +++ /dev/null @@ -1,68 +0,0 @@ -Debian SQL database -~~~~~~~~~~~~~~~~~~~ - -Most OpenStack services use an SQL database to store information. The -database typically runs on the controller node. The procedures in this -guide use MariaDB or MySQL depending on the distribution. OpenStack -services also support other SQL databases including -`PostgreSQL `__. - - -Install and configure components --------------------------------- - -#. Install the packages: - - - -.. code-block:: console - - # apt install mysql-server python-pymysql - -.. end - - - - - -2. Create and edit the ``/etc/mysql/conf.d/openstack.cnf`` file - and complete the following actions: - - - Create a ``[mysqld]`` section, and set the ``bind-address`` - key to the management IP address of the controller node to - enable access by other nodes via the management network. Set - additional keys to enable useful options and the UTF-8 - character set: - - .. path /etc/mysql/conf.d/openstack.cnf - .. code-block:: ini - - [mysqld] - bind-address = 10.0.0.11 - - default-storage-engine = innodb - innodb_file_per_table = on - max_connections = 4096 - collation-server = utf8_general_ci - character-set-server = utf8 - - .. end - - - - -Finalize installation ---------------------- - - -#. Restart the database service: - - .. code-block:: console - - # service mysql restart - - .. end - - - -