Перейти к основному содержимому Перейти к дополнительному содержимому
Ресурсы Qlik

Поиск и устранение неисправностей Direct Access Gateway

В этом разделе описаны различные способы устранения неполадок Direct Access Gateway.

Просмотр и загрузка файлов журналов

Файлы журнала содержат информацию об операциях Direct Access Gateway. Qlik Служба поддержки может попросить журналы для поиска и устранения неполадок. Можно просматривать или загружать файлы журнала в средстве просмотра журнала. В нормальных обстоятельствах не возникает причин изучать файлы журналов, но если возникают повторяющиеся сбои или другие проблемы, то журналы часто помогают выявить их причину.

Примечание к информацииДля просмотра и загрузки журналов требуется роль Может использовать данные.

Чтобы открыть средство просмотра журнала, выполните следующие действия.

  1. В Консоль управления перейдите в раздел Шлюзы данных и найдите Direct Access Gateway.

  2. Нажмите кнопку в конце строки и выберите Просмотреть журналы.

    Откроется окно Средство просмотра журнала.

  3. В раскрывающемся списке вверху слева выберите тип журнала, который служба поддержки Qlik просит просмотреть или загрузить.

    Доступны следующие журналы:

    • Журналы Direct Access Gateway (DirectAccessAgent)
    • Журналы DCaaS(dcaas_logs)
    • Журналы коннектора на основе ODBC (odbc-connector_logs)
    • Журналы коннектора SAP BW (QvSAPBwConnector-<дата + метка времени>)
    • Журналы коннектора SAP SQL (QvSqlBwConnector-<дата +метка времени>)
    • Журналы агента коннектора (connector-agent_logs_<дата>)

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

    Примечание к подсказкеФайл журнала не обновляется автоматически в соответствии с последними сообщениями. Для обновления вида нажмите , чтобы перейти в конец журнала, где будут отображаться самые недавние сообщения.

  5. Чтобы загрузить файл журнала, нажмите кнопку Загрузить.

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

Открытие журналов Direct Access Gateway на машине Direct Access Gateway

Помимо возможности загружать журналы Direct Access Gateway (DirectAccessAgent) из Консоль управления, их также можно открывать непосредственно на компьютере с Direct Access Gateway. При установке по умолчанию эти журналы находятся в папке:

C:\Program Files\Qlik\ConnectorAgent\data\logs

Изменение уровня детализации журнала

Можно просматривать и изменять уровень детализации журнала Direct Access Gateway (DirectAccessAgent) по необходимости. Для этого выполните следующие команды из подпапки ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent при установке по умолчанию).

  • Для просмотра текущего уровня журнала выполните:

    connectoragent configuration getloggers

  • Чтобы перейти на уровень журнала «Отслеживание», выполните:

    connectoragent configuration setloggers -l Root -v DEBUG

  • Чтобы перейти на уровень журнала «Подробно«, выполните:

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Обновление регистрационного ключа

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

Чтобы обновить регистрационный ключ, выполните следующие действия.

  1. На сервере шлюза прямого доступа откройте командную строку от имени администратора и измените рабочий каталог на вложенную папку ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent при установке по умолчанию).

  2. Выполните следующую команду:

    • Создайте новый ключ:

      connectoragent qcs generate_keys

    • Отобразите ключ:

      connectoragent qcs get_registration

      Ключ отображается:

  3. Скопируйте ключ полностью, как показано в примере выше.

  4. В Консоль управления откройте настройки шлюза данных, нажав кнопку в конце соответствующей строки и выбрав Изменить.

  5. Вставьте ключ в поле Ключ (заменяя текущий ключ) и сохраните настройки.

  6. Вернитесь на сервер шлюза прямого доступа и переЗапустите сервис Qlik Data Gateway — Direct Access, как описано в Управление службой Qlik Data Gateway — Direct Access.

Сокращение случаев сбоя коннектора во время перезагрузки

Изоляция процессов позволяет администраторам, которые имеют прямой доступ к операционной системе сервера шлюза, контролировать количество процессов, доступных для перезагрузок по типу коннекторов. Распространение перезагрузок по нескольким процессам коннектора повышает степень изоляции путем уменьшения количества перезагрузок, выполняемых одновременно для каждого процесса коннектора. Это, в свою очередь, улучшает общую стабильность Direct Access Gateway в случаях, когда коннектор неожиданно завершает работу.

Примечание к информации

Требуется Direct Access Gateway 1.6.1 или более поздней версии.

Чтобы включить изоляцию процесса, выполните следующие действия.

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

    Файл содержит три префикса, соответствующие разным типам коннекторов: ODBC_<имя_свойства>, SAPBW_<имя_свойства> и SAPSQL_<имя_свойства>.

  2. Задайте для ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE значение Load (Загрузить) и для ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT значение N.

    Где:

    N = один процесс команды + количество одновременных процессов перезагрузки для распределения. Так, например, значение 10 означает максимум 9 одновременных перезагрузок.

    Примечание к информации

    Для [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT нельзя задать значение больше 10 при использовании номера порта и диапазона по умолчанию.

  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Чтобы выключить изоляцию процесса, выполните следующие действия.

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

  2. Задайте для ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE значение None (Нет).

  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Примеры изоляции процесса коннектора ODBC

Следующий фрагмент файла configuration.properties демонстрирует включение изоляции процесса коннектора ODBC для максимум 9 перезагрузок.

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

В случае изменения параметров порта по умолчанию значение MAX_PROCESS_COUNT может превышать 10. Однако в данном случае:

  • Количество портов между ODBC_PORT или ODBC_DATA_PORT_RANGE_START и SAPBW_PORT или SAPBW_DATA_PORT_RANGE_START должны быть равны или больше ODBC_MAX_PROCESS_COUNT

  • Количество портов между SAPBW_PORT или SAPBW_DATA_PORT_RANGE_START и SAPSQL_PORT или SAPSQL_DATA_PORT_RANGE_START должны быть равны или больше SAPB W_MAX_PROCESS_COUNT

Так, например, чтобы задать ODBC_MAX_PROCESS_COUNT=30, параметры порта должны выглядеть примерно так:

# ODBC Connector

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=30

ODBC_DATA_PORT_RANGE_START=50260

ODBC_PORT=3005

# SAP BW Connector

SAPBW_PROCESS_ISOLATION_MODE=None

SAPBW_MAX_PROCESS_COUNT=0

SAPBW_DATA_PORT_RANGE_START=50290

SAPBW_PORT=3035

# SAP SQL Connector

SAPSQL_PROCESS_ISOLATION_MODE=None

SAPSQL_MAX_PROCESS_COUNT=0

SAPSQL_DATA_PORT_RANGE_START=50300

SAPSQL_PORT=3045

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!

Оставьте свой отзыв здесь