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

Details

    • 5
    • False
    • None
    • False
    • Not Started
    • Not Started
    • Not Started
    • Not Started
    • Not Started
    • Not Started

    Description

      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
      

       

       

      Attachments

        Activity

          People

            dfenness@redhat.com Darren Fennessy
            rhn-support-atra An Tran
            Darren Fennessy Darren Fennessy
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated: