Нештатные ситуации и способы их устранения

Возможные неисправности при установке Termidesk VDI и способы их устранения приведены в таблице (см. таблицу Перечень возможных нештатных ситуаций).

Индикация Описание Возможное решение

Веб-интерфейс не отображается после установки

После установки веб-интерфейс не отображается, в журналах веб-сервера Apache присутствуют ошибки при доступе по адресу веб-интерфейса

Для исправления ситуации нужно:

проанализировать ошибки журнала Syslog;
проверить существование файла termidesk.conf;
проверить права доступа на файл termidesk.conf:

sudo -u termidesk test -r /etc/opt/termidesk-vdi/termidesk.conf && echo "Success" || echo "Error"

если после выполнения команды вернулся ответ Error, то поменять права на каталог /etc/opt/termidesk-vdi, например:

sudo chmod 755 /etc/opt
sudo chmod 755 /etc/opt/termidesk-vdi

Предупреждение о некорректных параметрах локализации

При установке отображается диалог с сообщением: «The current session uses an invalid locale: LC_CTYPE="UTF-8"». Проблема возникает, если в системе некорректно заданы параметры локализации, например LC_CTYPE=UTF-8

Для исправления ситуации нужно:

прервать установку, нажав кнопку [Abort];
проверить текущие параметры локализации с помощью команды locale;
если параметры заданы некорректно (например, LC_CTYPE=UTF-8), посмотреть список доступных значений в системе:

locale -a

установить одно из доступных значений, например C.UTF-8:

export LC_CTYPE=C.UTF-8

после исправления параметров локализации запустить установку заново

СУБД PostgreSQL не запускается после обновления ОС Astra Linux Special Edition

После обновления ОС Astra Linux Special Edition СУБД PostgreSQL может не запускаться, из-за чего не работают службы Termidesk (termidesk-vdi, termidesk-celery-beat, termidesk-celery-worker).

В журнале службы СУБД PostgreSQL появляется сообщение: «Неверное значение для параметра "ac_audit_mode": "internal"».

Параметр ac_audit_mode со значением internal больше не поддерживается в новых версиях ОС Astra Linux Special Edition

Ситуация возникает при обновлении ОС Astra Linux Special Edition с установленной СУБД PostgreSQL из состава ОС. Ситуация не связана с работой Termidesk, однако может повлиять на процесс обновления фермы Termidesk VDI.

Для восстановления работоспособности СУБД PostgreSQL необходимо:

в файле /etc/postgresql/15/main/postgresql.conf изменить значение параметра:

ac_audit_mode = default

перезапустить СУБД PostgreSQL:

sudo systemctl restart postgresql

После успешного запуска СУБД PostgreSQL службы Termidesk запускаются штатно

После обновления брокера сообщений RabbitMQ не создаются очереди сообщений

После обновления брокера сообщений RabbitMQ очереди сообщений не создаются. В журнале брокера сообщений отображается ошибка: «operation queue.declare caused a connection exception internal_error: "Feature transient_nonexcl_queues is deprecated. By default, this feature is not permitted anymore."»

Ситуация возникает при использовании устаревших функций брокера сообщений RabbitMQ.

Для восстановления работоспособности брокера сообщений RabbitMQ нужно:

отредактировать файл /etc/rabbitmq/rabbitmq.conf;
добавить строку с указанием устаревшей функции для использования обратной совместимости:
```
deprecated_features.permit.transient_nonexcl_queues = true
```
перезапустить службу rabbitmq-server:
```
sudo systemctl restart rabbitmq-server
```

Проблемы в работе задач «Менеджера рабочих мест»

В работе Termidesk VDI наблюдаются проблемы, при этом в журнале службы termidesk-celery-worker присутствует ошибка: «TimeoutError: The read operation timed out»

По умолчанию параметр CELERY_TASK_TIME_LIMIT имеет значение 0, при котором время выполнения задач не ограничивается. Если задан ненулевой таймаут и его недостаточно для выполнения задач, значение следует увеличить. Чтобы полностью снять ограничение, нужно задать значение 0. Например:

CELERY_TASK_TIME_LIMIT = 600

После изменения параметра нужно перезапустить службу termidesk-celery-worker:

sudo systemctl restart termidesk-celery-worker