Параметры конфигурирования компонентаПараметры Шлюза задаются переменными, описанными в файле |
Перечень доступных переменных и аргументов приведен в таблице.
|
|
Далее информация относится к новому (экспериментальному) Шлюзу termidesk-gateway. |
Параметры конфигурирования нового Шлюза задаются из конфигурационного файла /etc/termidesk/termidesk-gateway.conf при условии определения переменных в файле /lib/systemd/system/termidesk-gateway.service.
При необходимости переопределить параметры запуска Шлюза через интерфейс командной строки, необходимо сначала остановить службу:
Помимо аргументов командной строки параметры запуска службы могут быть переопределены в |
Пример файла /lib/systemd/system/termidesk-gateway.service:
[Unit]
Description=Termidesk Gateway
After=network.target
[Service]
Environment=wsServerIP=0.0.0.0
Environment=wsServerPort=5099
Environment=urlCheckToken=http: /127.0.0.1:8000/api/wsproxy/v1/verify
Environment=gatewayLogMode="-l"
Environment=wsIdleTimeout=30
Environment=mgtServerIP=0.0.0.0
Environment=mgtServerPort=8444
Environment=wssServerIP=0.0.0.0
Environment=wssServerPort=8443
Environment=sslKey=/etc/termidesk/ssl-cert-snakeoil.key
Environment=sslCert=/etc/termidesk/ssl-cert-snakeoil.pem
Environment=healthCheckAccessKey=a0e08d1b0e95dfea4f431d5849b934e09ac5067b
EnvironmentFile=-/etc/termidesk/termidesk-gateway.conf
Restart=on-failure
RestartSec=5
User=termidesk-gateway
Group=termidesk-gateway
ExecStart=/usr/bin/termidesk-gateway ${gatewayLogMode} \
-wsServerIP=${wsServerIP} -wsServerPort=${wsServerPort} \
-urlCheckToken=${urlCheckToken} -wsIdleTimeout=${wsIdleTimeout} \
-mgtServerIP=${mgtServerIP} -mgtServerPort=${mgtServerPort} \
-healthCheckAccessKey=${healthCheckAccessKey} \
-wssServerIP=${wssServerIP} \
-wssServerPort=${wssServerPort} \
-sslKey=/etc/termidesk/ssl-cert-snakeoil.key \
-sslCert=/etc/termidesk/ssl-cert-snakeoil.pem
[Install]
WantedBy=multi-user.target |
Для задания параметров конфигурирования нового Шлюза из файла необходимо:
- создать каталог
/etc/termidesk/, если его нет:
:~$ sudo mkdir /etc/termidesk/ |
- создать пустой файл
/etc/termidesk/termidesk-gateway.conf:
:~$ sudo touch /etc/termidesk/termidesk-gateway.conf |
- отредактировать файл
termidesk-gateway.conf, указав необходимые значения для параметров:
# Адреса, на которых принимать входящие подключения wsServerIP=0.0.0.0 # Прослушиваемый порт для входящих подключений wsServerPort=5099 # Адрес брокера, по которому будет осуществляться проверка пользовательских подключений в случае комплексной установки # Если программный комплекс Termidesk установлен в распределенном варианте, вместо 127.0.0.1 следует указать адрес балансировщика urlCheckToken=https://127.0.0.1/api/wsproxy/v1/verify # Интервал установки соединения (в секундах) wsIdleTimeout=30 # Режим журналирования. gatewayLogMode=-l - включить отладку уровня INFO. # gatewayLogMode="-d" - включить отладку уровня DEBUG. # Пустое значение параметра gatewayLogMode= - выключить отладку. # Адрес для доступа к API # Если нужно, чтобы доступ был у внешних систем, то вместо 127.0.0.1 следует указать 0.0.0.0 mgtServerIP=127.0.0.1 # Порт для доступа к API mgtServerPort=8102 # Ключ доступа для аутентификации запросов к API. Указание значения ключа обязательно # При задании ключа его размер должен составлять от 0 до 64 символа, должны использоваться символы в шестнадцатеричной системе (0-9, a-f) healthCheckAccessKey=a0e08d1b0e95dfea4f431d5849b934e09ac5067b |
- выполнить перезагрузку службы и модуля:
:~$ systemctl daemon-reload & systemctl restart termidesk-gateway.service |
Доступные параметры, а также аргументы командной строки для нового Шлюза приведены в таблице.
Для получения информации по доступным параметрам из интерфейса командной строки, необходимо выполнить команду:
:~$ termidesk-gateway --help |
|
Пример команды проверки состояния компонента через утилиту curl для нового Шлюза termidesk-gateway:
:~$ curl -v -s -X 'GET' "${HOSTNAME}:8102/api/health" -H 'accept: application/json' -H "Authorization: Token ${HEALTH_CHECK_ACCESS_KEY}" --fail -w "\n%{http_code}\n" |