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

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

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

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

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

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

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

Отключите сохранение резервных копий данных на диск, закомментировав следующие строки:
```
save 900 1
save 300 10
save 60 10000
```
Затем установите значение параметра appendonly в no (по умолчанию).
Измените политику перезаписи данных при нехватке памяти на allkeys-lru (удаление наименее используемых данных):
```
maxmemory-policy allkeys-lru
```
Чтобы избежать ошибок при подключении, привяжите адрес в конфигурационном файле Redis:
```
sudo nano /etc/redis/redis.conf
```
В конце строки bind 127.0.0.1 ::1 укажите корректный адрес кэш-сервера.

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

sudo systemctl restart redis-server.service

Подключение должно работать корректно. Проверить, что сервер обращается к нужному адресу можно следующей командой:
```
ss -tunlp | grep :6379
```

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

При выборе провайдера "Redis" в группе настроек "Производительность БД" становятся доступными следующие поля:

Строка подключения

В поле указывается строка подключения к Redis.

Пример настройки подключения к Redis приведён в разделе Настроить кэш-сервер Redis.

Пароль

Пароль для доступа к Redis. Требуется заполнять только в том случае, если настроена аутентификация при помощи пароля. При изменении адреса в "Строке подключения", пароль будет сброшен, потребуется ввести пароль заново.

Тест

При нажатии кнопки выполняется проверка подключения на стороне сервера Docsvision. Если не заполнена строка подключения, кнопка неактивна.

Рисунок 1. Настройка подключения к серверу Redis

Чтобы настроить подключение к серверу Redis:

Перейдите в раздел настроек Серверы Имя-сервера Сервер приложений Базы данных.
В таблице нажмите на строку настраиваемой базы данных, при работе с которой сервер будет кэшировать данные в Redis.
В группе настроек "Производительность", в пункте "Настройки провайдера" выберите из раскрывающегося списка значение Redis. Будет разблокировано поле Строка подключения.
Введите в поле Строка подключения адрес и порт для подключения к компьютеру с Redis в формате адрес:Порт. По умолчанию Redis использует порт 6379.

Сетевые политики должны разрешать подключения с серверов Docsvision к Redis.
Нажмите кнопку Тест, чтобы проверить соединение с Redis, при возникновении ошибки подробности будут отображены на странице настроек.
Сохраните изменения настроек базы данных.
Если настраивается кластер серверов Docsvision, подключите все сервера к одному кэш-серверу Redis.