# 管理 Qlik Data Gateway - Direct Access 服务器

本节介绍安装 Qlik Data Gateway - Direct Access 后可用的各种连接和管理选项。

## 通过代理服务器连接到 Qlik Cloud

如果在初始设置中未配置代理连接，则可以稍后通过运行下面描述的命令进行配置。您还可以运行相同的命令来编辑现有代理服务器设置。

### 限制和考虑事项

* 仅支持 HTTP 代理架构。

* 不支持配置为拦截 SSL 连接（用于内容检查或其他安全措施）的代理服务器。

* 除了 HTTPS，直接访问网关还使用 WSS (WebSocket Secure) 协议。因此，请确保防火墙和代理服务器（如果您打算使用）设置为允许出站 WSS 连接。

### 启用代理服务器连接

您可以按如下方式启用或编辑代理服务器连接：

1. 根据安装工作流程，执行以下操作之一：

   * Windows 服务器安装：

     以管理员身份打开命令提示符并将工作目录更改为 ConnectorAgent 子文件夹（对于默认安装为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

   * 容器化安装：

     在 direct-access-agent 容器中打开控制台。

2. 然后运行以下命令：

   * Windows 服务器安装：

     * 语法： connectoragent qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * 示例： connectoragent qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   * 容器化安装：

     * 语法： dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * 示例： dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

3. 根据安装工作流程，执行以下操作之一：

   * Windows 服务器安装：

     重新启动 Qlik Data Gateway - Direct Access 服务，如[管理 Qlik Data Gateway - Direct Access 服务](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing)中所述。

   * 容器化安装：

     重启 direct-access-agent 容器。

### 禁用代理服务器连接

您可以按如下方式关闭代理服务器连接：

1. 以管理员身份打开命令提示符并将工作目录更改为 ConnectorAgent 子文件夹（对于默认安装为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

2. 根据安装工作流程，执行以下操作之一：

   * Windows 服务器安装：

     以管理员身份打开命令提示符并将工作目录更改为 ConnectorAgent 子文件夹（对于默认安装为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

   * 容器化安装：

     在 direct-access-agent 容器中打开控制台。

3. 然后运行以下命令：

   connectoragent qcs set\_config --proxy\_url ""

   * Windows 服务器安装：

     connectoragent qcs set\_config --proxy\_url ""

   * 容器化安装：

     dotnet ConnectorAgent.dll qcs set\_config --proxy\_url ""

4. 根据安装工作流程，执行以下操作之一：

   * Windows 服务器安装：

     重新启动 Qlik Data Gateway - Direct Access 服务，如[管理 Qlik Data Gateway - Direct Access 服务](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing)中所述。

   * 容器化安装：

     重启 direct-access-agent 容器。

## 更新 Qlik Cloud 租户 URL

您可以根据需要更改 Qlik Cloud 租户 URL。

为此：

1. 在 Direct Access gateway 服务器上，以管理员身份打开命令提示符并将工作目录更改为 ConnectorAgent 子文件夹（对于默认安装为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

2. 根据您的安装工作流程，运行以下命令之一：

   * Windows 服务器安装：

     * 语法： connectoragent qcs set\_config --tenant\_url URL

     * 示例： connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   * 容器化安装：

     * 语法： dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

     * 示例： dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

3. 重新启动 Qlik Data Gateway - Direct Access 服务，如[管理 Qlik Data Gateway - Direct Access 服务](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing)中所述。

信息注释更新 Qlik Cloud 租户 URL 还需要您生成新的注册密钥，如 [第二阶段：安装或部署 Direct Access gateway](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) 中所述（并对其进行注册，如 [阶段四：注册数据网关](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4) 中所述）。

## 查看当前的直接访问网关服务器设置

您可以查看当前的 Direct Access gateway 服务器设置。

为此：

1. 根据您的安装工作流程，执行以下操作之一：

   * Windows 服务器安装：

     在 Direct Access gateway 服务器上，以管理员身份打开命令提示符并将工作目录更改为 ConnectorAgent 子文件夹（对于默认安装为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

   * 容器化安装：

     在 direct-access-agent 容器中打开控制台。

2. 根据您的安装工作流程，运行以下命令之一：

   * Windows 服务器安装：

     connectoragent qcs set\_config --tenant\_url URL

   * 容器化安装：

     dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

   将显示您当前的设置。

   ```
   connector-agent starting....
   --tenant_url "elastic.example"
   --proxy_url ""
   --proxy_username ""
   DirectAccessAgent Control Program completed successfully.
   ```

## 管理 Qlik Data Gateway - Direct Access 服务

信息注释仅适用于 Windows 服务器安装。

更改 Direct Access gateway 服务器上的设置后，需要重新启动 Qlik Data Gateway - Direct Access 服务。您还可以使用其他帐户运行该服务。

### 启动、停止或重新启动服务

在 Direct Access gateway 服务器上，执行以下操作之一以停止、启动或重新启动服务：

* 打开 Windows 服务控制台，根据需要停止、启动或重新启动 Qlik Data Gateway - Direct Access 服务。

* 以管理员身份打开命令提示符并将工作目录更改为 ConnectorAgent 子文件夹（对于默认安装为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。然后运行以下命令：

  connectoragent service stop

  将显示服务成功停止的确认。

  connectoragent service start

  将显示服务成功启动的确认。

### 使用其他帐户运行该服务。

默认情况下，Qlik Data Gateway - Direct Access 服务在本地系统帐户下运行。要在其他帐户下运行服务，请在 Windows 服务控制台中右键单击 Qlik Data Gateway - Direct Access，然后选择登录选项卡。然后选择此帐户并输入帐户详细信息。完成后，保存设置并重新启动服务。

## 可用命令类别

若要查看可用命令类别列表：

1. 根据您的安装工作流程，执行以下操作之一：

   * Windows 服务器安装：

     以管理员身份打开命令提示符，并将工作目录更改为 ConnectorAgent 子文件夹（默认安装时为 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent）。

   * 容器化安装：

     在 direct-access-agent 容器中打开控制台。

2. 根据您的安装工作流程，运行以下命令之一：

   * Windows 服务器安装：

     connectoragent help

   * 容器化安装：

     dotnet ConnectorAgent.dll help

将显示以下列表：

* service - 请参阅上面的管理 Qlik Data Gateway - Direct Access 服务。

* qcs - 必须在所有记录的命令之前，服务命令除外。

  示例（Windows 服务器安装）：

  connectoragent qcs show\_config

  示例（容器化安装）：

  dotnet ConnectorAgent.dll qcs show\_config

* setup - 仅用于支持用途。

* repository - 仅用于支持用途。

* configuration - 仅用于支持用途。