Перейти к содержанию

Диагностика ошибок подключения Glint

При возникновении ошибок подключения Glint требуется анализ файлов логирования. В статье описаны пути расположения файлов логирования и сценарии диагностики.

Расположение файлов логирования

Журналы glint-launcher

Файлы логирования glint-launcher расположены в директории /opt/glint-launcher/journal.log. На glint-launcher возможно включить debug-режим. Для этого необходимо в файле /etc/systemd/system/glint-launcher.service в поле ExecStart=/opt/glint-launcher/glint-launcher добавить --debug.

Пример файла /etc/systemd/system/glint-launcher.service при включенном debug-режиме
[Unit]
# Human readable name of the unit
Description=Glint Launcher
After=syslog.target
After=network.target

[Service]
WorkingDirectory=/opt/glint-launcher
User=root
OOMScoreAdjust=-1000
ExecStart=/opt/glint-launcher/glint-launcher --debug
TimeoutSec=30
PDPLabel=0:0
Type=notify

# Automatically restart the service if it crashes
Restart=always
KillMode=process

# File logging
StandardOutput=append:/opt/glint-launcher/journal.log
StandardError=append:/opt/glint-launcher/journal.log

[Install]
# Tell systemd to automatically start this service when the system boots
# (assuming the service is enabled)
WantedBy=default.target

Затем необходимо применить изменения с помощью команды:

sudo systemctl daemon-reload

Перезапустить glint-launcher:

sudo systemctl restart glint-launcher.service


Журналы sssd

В случае ошибок авторизации по JaCarta необходимые файлы логирования можно найти в директории /var/log/sssd.

Сразу получить файлы логирования sssd и glint-launcher можно с помощью команды:

sudo tar -czf logs_$(date +%Y%m%d_%H%M%S).tar.gz \
    /var/log/sssd \
    /opt/glint-launcher/journal.log

После выполнения команды произойдет создание архива logs_<дата создания>.tar.gz, в котором будут все необходимые файлы логирования.


Журналы Space Client

Файлы логирования Space Client хранятся на АРМ, на которой запускается Space Client.

  • На АРМ с ОС Linux лог-файлы сохраняются в каталог /home/{текущий пользователь}/SpaceClient/log.
  • На АРМ с ОС Windows лог-файлы сохраняются в каталог C:\Users\{текущий пользователь}\AppData\Local\SpaceClient\log.
  • На АРМ с ОС MacOS лог-файлы сохраняются в каталог /Users/{текущий пользователь}/SpaceClient/log.

Рекомендованный способ получения файлов логирования:

  • Очистить лог-файлы, удалив папку log.
  • Перезапустить Space Client.
  • Подключиться к удаленной АРМ и воспроизвести ошибку.
  • Передать для диагностики всю папку с лог-файлами.

Журналы USBIP-сервера (space-usbip-daemon)

Файлы логирования USBIP-сервера хранятся на удаленной ВМ/ФМ, к которой происходит подключение. Путь расположения файлов: /opt/space-usbip-daemon/journal.log.


Сценарии диагностики ошибок

Внутренняя ошибка лаунчера

При подключении к удаленной ВМ/ФМ с обычной авторизацией (не доменным пользователем и без использования токена JaCarta) в Space Client отобразилась ошибка «Внутренняя ошибка лаунчера».

Для диагностики проблемы необходимо получить лог-файлы glint-launcher, находящиеся в /opt/glint-launcher/journal.log.


Ошибка авторизации или внутренняя ошибка лаунчера

При подключении к удаленной ВМ/ФМ с авторизацией по токену или доменным пользователем в Space Client отобразилась «Ошибка авторизации» или «Внутренняя ошибка лаунчера». Для диагностики проблемы необходимо получить лог-файлы glint-launcher и sssd. Для этого использовать команду:

sudo tar -czf logs_$(date +%Y%m%d_%H%M%S).tar.gz \
    /var/log/sssd \
    /opt/glint-launcher/journal.log

Файлы логирования glint-launcher и sssd будут собраны в один архив.


Ошибка 0x2000D

При подключении к удаленной ВМ/ФМ возникла ошибка 0x2000D.

Ошибка 0x2000D

image

Для диагностики проблемы необходимо получить лог-файлы glint-launcher, находящиеся в /opt/glint-launcher/journal.log..

Ошибка может происходить из-за того, что Space Gateway не обеспечил прохождение трафика от Space Client до удаленной ВМ/ФМ. Также причиной может быть блокировка брандмауэром порта, по которому идет подключение.


Некорректное тело запроса

Если при подключении к удаленной ВМ/ФМ в Space Client отобразилась ошибка «Некорректное тело запроса», необходимо включить debug-режим для glint-launcher и повторить подключение. Если ошибка повторилась, обратиться к лог-файлам glint-launcher.