diff --git a/doc/source/user/prod/gnocchi_redis.rst b/doc/source/user/prod/gnocchi_redis.rst index 699e33b04b..43c41a5ecb 100644 --- a/doc/source/user/prod/gnocchi_redis.rst +++ b/doc/source/user/prod/gnocchi_redis.rst @@ -22,11 +22,11 @@ You have to add some pip packages to your gnocchi setup: - cryptography - gnocchiclient # this is what we want: - # - "gnocchi[mysql,ceph,ceph_alternative_lib,redis]" + # - "gnocchi[mysql,ceph,ceph_alternative_lib,redis,keystone]" # but as there is no librados >=12.2 pip package we have to first install ceph without alternative support # after adding the ceph repo to gnocchi container, python-rados>=12.2.0 is installed and linked automatically # and gnocchi will automatically take up the features present in the used rados lib. - - "gnocchi[mysql,ceph,redis]" + - "gnocchi[mysql,ceph,redis,keystone]" - keystonemiddleware - python-memcached @@ -50,7 +50,7 @@ storage for your gnocchi installation. The `supported storage systems`_ are: .. _supported storage systems: https://gnocchi.xyz/intro.html#incoming-and-storage-drivers -When your Swift installation uses Ceph as backend, the only one left for this +When your Swift API endpoint uses Ceph as a backend, the only one left for this setup is Redis. So first of all setup a redis server/cluster, e.g. with this `ansible role`_. @@ -64,7 +64,7 @@ Cluster as incoming storage: gnocchi_conf_overrides: incoming: driver: redis - redis_url: redis://{{ hostvars[groups['redis-master'][0]]['ansible_default_ipv4']['address'] }}:{{ hostvars[groups['redis-master'][0]]['redis_sentinel_port'] }}?sentinel=master01{% for host in groups['redis-slave'] %}&sentinel_fallback={{ hostvars[host]['ansible_default_ipv4']['address'] }}:{{ hostvars[host]['redis_sentinel_port'] }}{% endfor %} + redis_url: redis://{{ hostvars[groups['redis-master'][0]]['ansible_default_ipv4']['address'] }}:{{ hostvars[groups['redis-master'][0]]['redis_sentinel_port'] }}?sentinel=master01{% for host in groups['redis-slave'] %}&sentinel_fallback={{ hostvars[host]['ansible_default_ipv4']['address'] }}:{{ hostvars[host]['redis_sentinel_port'] }}{% endfor %}&db=0 You also have to install additional pip/distro packages to use the redis cluster: @@ -77,11 +77,13 @@ cluster: - libapache2-mod-wsgi - git - build-essential - - python-dev + - python3-dev + - librados-dev - libpq-dev - - python-rados + - python3-rados # additional package for python redis client - - python-redis + - python3-redis + - libsystemd-dev .. code-block:: yaml @@ -89,14 +91,15 @@ cluster: - cryptography - gnocchiclient # this is what we want: - # - "gnocchi[mysql,ceph,ceph_alternative_lib,redis]" + # - "gnocchi[mysql,ceph,ceph_alternative_lib,redis,keystone]" # but as there is no librados >=12.2 pip package we have to first install ceph without alternative support # after adding the ceph repo to gnocchi container, python-rados>=12.2.0 is installed and linked automatically # and gnocchi will automatically take up the features present in the used rados lib. - - "gnocchi[mysql,ceph,redis]" + - "gnocchi[mysql,ceph,redis,keystone]" - keystonemiddleware - python-memcached - redis + - systemd-python .. note:: @@ -154,14 +157,15 @@ You also have to install additional packages: - cryptography - gnocchiclient # this is what we want: - # - "gnocchi[mysql,ceph,ceph_alternative_lib,redis]" + # - "gnocchi[mysql,ceph,ceph_alternative_lib,redis,keystone]" # but as there is no librados >=12.2 pip package we have to first install ceph without alternative support # after adding the ceph repo to gnocchi container, python-rados>=12.2.0 is installed and linked automatically # and gnocchi will automatically take up the features present in the used rados lib. - - "gnocchi[mysql,ceph,redis]" + - "gnocchi[mysql,ceph,redis,keystone]" - keystonemiddleware - python-memcached - redis + - systemd-python # addiitional pip packages needed for zookeeper coordination backend - tooz - lz4