Настроить кэш-сервер Redis

Важным условием для корректной работы системы Docsvision, включающей несколько процессов сервера Docsvision, является использование всеми процессами общего серверного кэша. Рассинхронизация кэша может стать причиной появления неактуальных данных и других ошибок. В качестве хранилища распределенного кэша в Docsvision выступает кэш-сервер Redis.

Для работы с Redis лицензия Docsvision должна содержать опцию Docsvision кэш-сервер Redis. Отсутствие лицензии приведёт к ошибке в работе сервера Docsvision.

Кэш-сервер Redis не поддерживает работу в ОС Microsoft Windows.

Инструкцию по установке Redis см. в документации к кэш-серверу. Системные требования Redis зависят от желаемой производительности, ориентиры представлены в статье How fast is Redis?, и требованиях Redislabs.

Требования к настройке Redis

После установки Redis измените настройки в конфигурационном файле redis.conf:

  1. Отключите сохранение резервных копий данных на диск, закомментировав следующие строки:

    save 900 1
save 300 10
save 60 10000

  2. Затем установите значение параметра appendonly в no (по умолчанию).

  3. Измените политику перезаписи данных при нехватке памяти на allkeys-lru (удаление наименее используемых данных):

    maxmemory-policy allkeys-lru

  4. Чтобы избежать ошибок при подключении, привяжите адрес в конфигурационном файле Redis:

    sudo nano /etc/redis/redis.conf

    В конце строки bind 127.0.0.1 ::1 укажите корректный адрес кэш-сервера.

  5. Перезапустите Redis:

    sudo systemctl restart redis-server.service

  6. Подключение должно работать корректно. Проверить, что сервер обращается к нужному адресу можно следующей командой:

    ss -tunlp | grep :6379

Подключение Redis к Docsvision

  1. Откройте Консоль настройки Docsvision

  2. Перейдите в раздел настроек Настройки сервера  Базы данных.

  3. Выберите настраиваемую базу данных, при работе с которой сервер будет кэшировать данные в Redis, и нажмите на кнопку Настройки.

    Будет открыто окно Свойства и управление базой данных.

  4. Перейдите на вкладку Настройки кэширования.

  5. Выберите в списке Провайдер значение Redis. Будет разблокировано поле Строка подключения.

  6. Введите в поле Строка подключения адрес и порт для подключения к компьютеру с Redis в формате IP-адрес:Порт. По умолчанию Redis использует порт 6379.

    Сетевые политики должны разрешать подключения с серверов Docsvision к Redis.

  7. Нажмите на кнопку Тест, чтобы проверить соединение с Redis. Результат проверки ("Успешно" или "Ошибка") отобразится в диалоговом окне.

  8. Сохраните изменения настроек базы данных.

  9. Если настраивается кластер серверов Docsvision, подключите все сервера к одному кэш-серверу Redis.