openstack-manuals/doc/install-guide/source/environment-memcached.rst
Iswarya_Vakati 562548269f [install] Changed configuration step for memcached
Fixes an error in the configuration step, and updates to
use controller, to fit with conventions.

Change-Id: I250c1ac9b5517fa3faadc4bb8b4cb26ee44110ee
Closes-Bug: #1661175
2017-03-21 22:45:58 +00:00

111 lines
2.1 KiB
ReStructuredText

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:
.. only:: ubuntu or debian
.. code-block:: console
# apt install memcached python-memcache
.. end
.. endonly
.. only:: rdo
.. code-block:: console
# yum install memcached python-memcached
.. end
.. endonly
.. only:: obs
.. code-block:: console
# zypper install memcached python-python-memcached
.. end
.. endonly
.. only:: ubuntu or debian
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``.
.. endonly
.. only:: rdo
2. Edit the ``/etc/sysconfig/memcached`` file and complete the
following actions:
* 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
OPTIONS="-l 127.0.0.1,::1,controller"
.. end
.. note::
Change the existing line ``OPTIONS="-l 127.0.0.1,::1"``.
.. endonly
Finalize installation
---------------------
.. only:: ubuntu or debian
* Restart the Memcached service:
.. code-block:: console
# service memcached restart
.. end
.. endonly
.. only:: rdo or obs
* Start the Memcached service and configure it to start when the system
boots:
.. code-block:: console
# systemctl enable memcached.service
# systemctl start memcached.service
.. end
.. endonly