2.3. Диагностика и техническая поддержка

Для проверки версии ПО клиента TIONIX VDI в командной строке (Windows или Linux) следует выполнить команду:

tionix_vdi_client --version

Для получения списка сессий и в некоторых других (диагностических) случаях, возможен запуск клиента VDI без использования графического интерфейса, при помощи опции --no-ui:

tionix_vdi_client --no-ui --username admin --password 123456 --project default

После опций –username, –password, –project указываются (через пробел) реквизиты доступа к VDI-машине, назначенной в рамках выделенного проекта (default) определенному пользователю (admin).

Выполнение клиентом операций сопровождается выводом (в стандартный поток) сообщений о производимых операциях. Например, если в облачной инфраструктуре создан VDI проект, но ещё не определена виртуальная машина, назначенная пользователю, то будут выведены следующие сообщения:

2020-07-10 09:40:04.392 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:89 [-] Performing request-vm action on http://lab.tnx:9365
2020-07-10 09:40:22.405 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:89 [-] Successfully connected to http://lab.tnx:9365.
2020-07-10 09:40:22.406 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:92 [-] Performing get-vm action on http://lab.tnx:9365
2020-07-10 09:40:27.514 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:92 [-] Performing get-vm action on http://lab.tnx:9365
2020-07-10 09:42:39.320 6018 Dummy-1 ERROR tionix_vdi_client.client request_window.py:92 [-] Сервер недоступен. Проверьте адрес подключения.
2020-07-10 09:42:39.321 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:92 [-] Unable to connect to cloud. Tries left: 2
2020-07-10 09:42:39.322 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:92 [-] Тайм-аут 15 секунд до повторного подключения к облаку.
2020-07-10 09:42:54.323 6018 Dummy-1 INFO tionix_vdi_client.client request_window.py:92 [-] Performing get-vm action on http://lab.tnx:9365
2020-07-10 09:42:54.396 6018 Dummy-1 INFO tionix_vdi_client.rdp request_window.py:57 [-] Running connection: user=vdi--test, ip=<IP-адрес>
2020-07-10 09:42:54.909 6018 Dummy-1 ERROR tionix_vdi_client.rdp request_window.py:57 [-] Remote Access Client sent a message: /bin/sh: 1: xfreerdp: not found

Из журнала (логирования) видно, что для подключения используется доменное имя – http://lab.tnx:9365 (вместо имени сервера может быть указан IP-адрес).

Наиболее критичными являются сообщения, отмеченные уровнем логирования ERROR:

ERROR … [-] Сервер недоступен. Проверьте адрес подключения. ERROR … [-] Remote Access Client sent a message: /bin/sh: 1: xfreerdp: not found

Из анализа ошибок может быть сделан однозначный вывод о том, что:

  • есть затруднения в работе с сетевой инфраструктурой (не установлено подключение к VPN);
  • не установлено дополнительное ПО поддержки терминального протокола (xfreerdp).

Большинство ошибок при подключении клиента могут быть связаны с вводом неверных настроек (реквизитов), а также – с временными нарушениями в работе инфраструктурной сети. Реже может возникать отказ, связанный со сбоями в работе сетевого оборудования или используемой линии связи.

Внимание.

Если не удалось установить точную причину ошибки, нарушающей нормальное функционирование TIONIX VDI клиента, рекомендуется выполнить самодиагностику клиента (Раздел 2.3.4) или обратиться с запросом в ТехПоддержку (Раздел 2.3.5).

2.3.1. MainThread ERROR

Внимание

всё ещё актуально?

Если удалить старую конфигурацию и попытаться запустить клиент без смены текущей директории, то в консоли (окне Терминала) будет выведена ошибка запуска:

<дата_время> <pid> MainThread ERROR tionix_vdi_client __init__.py:39 [-] Error in settings.py:132: OSError:[Errno 2] No such file or directory
<дата_время> <pid> MainThread ERROR tionix_vdi_client __init__.py:55 [-] Failed to show error messagebox: OSError:[Errno 2] No such file or directory

Необходимо сменить директорию, например – на домашнюю (cd $HOME).

<дата_время> <pid> MainThread ERROR tionix_vdi_client.settings.py:344 [-] Error while reading file: .../tnx_client_session

2.3.2. Журнал операций

Журнал (логирования) операций сохраняется в текстовом файле tionix-vdi-client.log, который создается в скрытой директории (.tionix-vdi-client). Права на создание, а также чтение и запись определены домашней директорией пользователя, в которой создана скрытая директория (начинается с точки).

Для просмотра журнала из командной строки (Linux) выполнить команду:

cat ~/.tionix-vdi-client/tionix-vdi-client.log

В Windows или Linux журнал операций может быть открыт с помощью любого из доступных текстовых редакторов.

2.3.3. Уровень логирования

В параметрах подключения может быть указан уровень логирования клиента. Доступные значения:

– DEBUG - фиксируются события с уровнями: DEBUG, INFO, WARNING, ERROR, CRITICAL;

– INFO - фиксируются события с уровнями: INFO, WARNING, ERROR, CRITICAL;

– WARNING - фиксируются события с уровнями: WARNING, ERROR, CRITICAL;

– ERROR - фиксируются события с уровнями: ERROR и CRITICAL;

– CRITICAL - фиксируются только события критического уровня.

Более подробная информация о логгировании модулей TIONIX приведена в документе Руководство по эксплуатации TIONIX VDC.

2.3.4. Самодиагностика

В случае, если произошли какие-либо неполадки в работе ПО клиента VDI, необходимо самостоятельно произвести самодиагностику модуля:

  • в ОС Linux – при помощи команды tionix_vdi_client –diagnostic;
  • в ОС Windows – при помощи приложения run_self_diagnostics.exe [1].

Результат самодиагностики записывается в файл журнала

TIONIX.VDIclient_self_diagnostics_YYYY-MM-DD.log

Файл журнала сохраняется в пользовательской директории, используемой для хранения файлов конфигурации.

[1]Диагностическое приложение расположено в корневой директории установленного модуля (TIONIX.VDIclient).

2.3.5. Запрос на получение помощи

Запрос помощи предполагает наличие доступа в Интернет и веб-браузера. По URL-ссылке происходит открытие доступного веб-браузера, назначенного для пользователя Рабочего стола (по-умолчанию).

Используется следующая URL-ссылка:

https://docs.tionix.ru/<номер_релиза>/tionix_modules/tionix-vdi-client-docs/index.html

Если доступ к сети Интернет организован, но по каким-либо причинам веб-страница с подсказкой не открылась, то следует обратиться в службу Технической Поддержки.

Рекомендуется перед настройкой TIONIX VDI клиента ознакомиться c разделом публичной документации, посвященным часто задаваемым вопросам. Для этого в окне веб-браузера необходимо ввести URL и выполнить переход:

https://docs.tionix.ru/<номер_релиза>/faq/index.html