Расширенные параметры сервера#

Расширенные параметры — дополнительные переменные файла /etc/default/rudesktop для нестандартных сценариев: диагностика, отладка, вынесенные хранилища, тонкая настройка relay

Предупреждение

Базовая настройка сервера не требует этих параметров. Используйте их только для конкретной задачи: неверные значения могут нарушить работу сервера, а временные значения диагностики — например, подробное логирование — возвращайте обратно после проверки

Изменения применяются так же, как для базовых параметров: правка файла и перезапуск rude restart

Аргументы relay#

RELAY_ARGS — аргументы, которые relay получает при каждом запуске. Переменная создаётся установщиком пустой

Основное применение — подключение TOML-конфигурации relay, подробнее — на странице Конфигурационный файл rudesktop-relay.toml:

RELAY_ARGS='-C /etc/rudesktop-relay.toml'

Аргумент

Назначение

-C, --config <PATH>

Путь к TOML-файлу конфигурации relay

-l, --loglevel <LEVEL>

Уровень логирования: trace, debug, info, warn, error

-t, --trace <LEVEL>

Запись в лог обмена сообщениями протокола между клиентами и сервером, уровень детализации 1–9

-p, --usepublicip

Возвращать клиенту адрес ретранслятора по тому узлу, к которому клиент подключился. Используется на сервере с несколькими сетевыми интерфейсами — подробнее в Смене и установке IP

Подсказка

Полный список аргументов relay выводит команда:

/usr/share/rudesktop/rudesktop-server --help

Настройка мостов с -C описана на странице Настройка мостов

Адрес главного сервера#

SETUP_SERVER — адрес главного сервера для узлов, развёрнутых не в режиме standalone (например, executor). Определяет адрес сервера установки — источник клиентских пакетов и публикуемых образов ОС; задаётся на каждой точке распространения. Если переменная не задана, используется PUBLIC_HOST:PUBLIC_PORT

Применяется на точках распространения — см. Настройка точек распространения

Модуль аналитики#

По умолчанию модуль аналитики (Apache Superset) использует адреса и базу данных основного сервера. Переменные ниже задают отдельные значения:

Переменная

Назначение

SUPERSET_PUBLIC_HOST / SUPERSET_PUBLIC_PORT

Публичный адрес модуля аналитики

SUPERSET_LOCAL_HOST / SUPERSET_LOCAL_PORT

Локальный адрес модуля аналитики

POSTGRES_SUPERSET_HOST / POSTGRES_SUPERSET_PORT / POSTGRES_SUPERSET_USER / POSTGRES_SUPERSET_PASSWORD

Подключение к базе данных модуля аналитики; по умолчанию наследуют значения POSTGRES_*

POSTGRES_SUPERSET_DB

Имя базы данных модуля аналитики; фиксированное значение superset

Подсказка

Пример настройки — на странице Смена адреса для модуля аналитики

Каталоги и хранилища#

Переменная

Назначение

DATA_DIR

Корневой каталог данных сервера: загруженные файлы и медиа, репозитории, сертификаты CA, kickstart-преднастройки. По умолчанию /var/lib/rudesktop

LOGS_DIR

Каталог логов сервера. По умолчанию /var/log/rudesktop

REPOSITORY_DISKS_DIR

Каталог хранилища образов дисков для установки ОС и миграции. По умолчанию <DATA_DIR>/disks

REPOSITORY_DISK_CACHE_MAX_SIZE

Максимальный размер локального кеша образов дисков. По умолчанию 10G

Важно

После смены DATA_DIR перенесите данные на новый путь и сохраните права пользователя rudesktop, иначе сервер не запустится

Пути relay#

Переменная

Назначение

CA_KEY_PATH

Путь к ключу корневого CA, которым relay подписывает сертификаты устройств и мостов. По умолчанию /var/lib/rudesktop/ca/CA.key

CA_CERT_PATH

Путь к сертификату корневого CA. По умолчанию /var/lib/rudesktop/ca/CA.pem

RZ_SERVER_LOG_PATH

Путь к файлу лога relay; расположение логов описано на странице Логи сервера. По умолчанию /var/log/rudesktop/server.log

Системный пользователь#

Примечание

Имя системного пользователя SYS_USER и группы SYS_GROUP (по умолчанию rudesktop) задаются до чтения файла конфигурации — указание их в /etc/default/rudesktop не действует