故障排除 Direct Access gateway

本节介绍了可以执行的各种操作以进行 Direct Access gateway 故障排除。

查看和下载日志文件

日志文件提供有关 Direct Access gateway 操作的信息。Qlik 支持人员可能会要求您提供日志文件以进行故障排除。您可以在日志查看器中查看或下载日志文件。在正常情况下，没有理由检查日志文件，但如果您遇到重复故障或其他问题，日志文件通常有助于查明原因。

要打开日志查看器，请执行以下操作：

1. 在 管理控制台 中，转到数据网关并找到您的 Direct Access gateway。

2. 单击行末尾的 ，然后选择查看日志。

   日志查看器窗口打开。

3. 从左上角的下拉列表中，选择 Qlik 支持部门要求您查看或下载的日志类型。

   有以下日志可用：

   • Direct Access gateway 日志 (DirectAccessAgent)
   • DCaaS logs (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 数据网关 - 直接访问 服务，如管理 Qlik 数据网关 - 直接访问 服务中所述。

减轻重新加载过程中的连接器崩溃

进程隔离 允许直接访问网关服务器操作系统的管理员控制每个连接器类型可用于重新加载的进程数。通过减少每个连接器进程上同时运行的重新加载次数，在多个连接器进程之间分散重新加载可以提高隔离级别。这反过来又可以在发生连接器崩溃的情况下提高整体 Direct Access gateway 稳定性。

要打开进程隔离：

1. 打开 C:\ProgramData\Qlik\Gateway\configuration.properties 文件。如果是通过 Windows 资源管理器执行此操作，请确保已选中显示隐藏的文件、文件夹和驱动器。

   该文件包含三个前缀，对应于不同的连接器类型：ODBC_<property-name>、SAPBW_<property-name> 以及 SAPSQL_<property-name>。

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 数据网关 - 直接访问 服务。

要关闭进程隔离：

1. 打开 C:\ProgramData\Qlik\Gateway\configuration.properties 文件。如果是通过 Windows 资源管理器执行此操作，请确保已选中显示隐藏的文件、文件夹和驱动器。

2. 将 ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE 设置为 None。

3. 保存 configuration.properties 文件并重新启动 Qlik 数据网关 - 直接访问 服务。

ODBC 连接器进程隔离示例

以下 configuration.properties 文件摘录显示了如何为最多 9 次重新加载启用 ODBC 连接器进程隔离：

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 或 SAP SQL_DATA_PORT_RANGE_ART 之间的端口数必须等于或大于 SAPBW_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