Uploaded image for project: 'Red Hat 3scale API Management'
  1. Red Hat 3scale API Management
  2. THREESCALE-10952

Documentation about Redis Sentinel is unclear

XMLWordPrintable

    • API CCS Sprint 44 (3Scale) 2

      Currently, the documentation integrate Redis Sentinel with 3scale is unclear and inaccurate.

       

      Set REDIS_STORAGE_SENTINEL_ROLE to a comma-separated list of sentinels hosts and ports, for example: :sentinelpwd@123.45.67.009:2711,:sentinelpwd@other-sentinel:2722

       

       Set REDIS_QUEUES_SENTINEL_ROLE to a comma-separated list of sentinels hosts and ports, for example: :sentinelpwd@123.45.67.009:2711,:sentinelpwd@other-sentinel:2722

      Both are incorrect, as role should only be master or slave, and they also conflict the the information provide in this section.

      The correct format that described in apisonator docs are as follow:

      CONFIG_REDIS_SENTINEL_HOSTS

      • URL of Redis sentinels.
      • Optional. Required only when using a Redis cluster with sentinels.
      • Applies to: listener, worker, cron.
      • Format: list of URLs separated by ","

      CONFIG_REDIS_SENTINEL_ROLE

      • Asks the sentinel for the URL of the master or a slave.
      • Optional. Defaults to master. Applies only when using a Redis cluster with sentinels.
      • Applies to: listener, worker, cron.
      • Format: master or slave.

      Customers also had difficulty finding the correct format for REDIS_QUEUES_URL and REDIS_STORAGE_URL. I suggest we should update the documentation to the content of this KCS article https://access.redhat.com/solutions/5413511 

      Example configuration that works:

      backend-redis
      REDIS_QUEUES_SENTINEL_HOSTS: root:<<password>>@redis_host1:26379,root:<<password>>@redis_host2:26379,root:<<password>>@redis_host3:26379
      REDIS_QUEUES_SENTINEL_ROLE: master
      REDIS_QUEUES_URL: redis://root:<<password>>@mymaster/1
      REDIS_STORAGE_SENTINEL_HOSTS: root:<<password>>@redis_host1:26379,root:<<password>>@redis_host2:26379,root:<<password>>@redis_host3:26379
      REDIS_STORAGE_SENTINEL_ROLE: master
      REDIS_STORAGE_URL: redis://root:<<password>>@mymaster/2
      system-redis: 
      SENTINEL_HOSTS: root:<<password>>@redis_host1:26379,root:<<password>>@redis_host2:26379,root:<<password>>@redis_host3:26379
      SENTINEL_ROLE: master
      URL: redis://root:<<password>>@mymaster/3
      

       

       

              Unassigned Unassigned
              rhn-support-atra An Tran
              Darren Fennessy Darren Fennessy
              Matej Dujava Matej Dujava
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Created:
                Updated: