# 管理 Qlik 資料閘道 - 直接存取 伺服器

本區段說明安裝 Qlik 資料閘道 - 直接存取 之後可使用的各種連線性和管理選項。

## 透過 Proxy 伺服器連線至 Qlik Cloud

若您沒有在初始設定中設定 Proxy 連線性，可以稍後執行下面描述的命令來進行。您也可以執行相同命令，以編輯現有的 Proxy 伺服器設定。

### 限制和考慮事項

* 僅支援 HTTP Proxy 結構描述。

* 不支援設定用來攔截 SSL 連線 (為了內容檢查或其他安全性措施) 的 Proxy 伺服器。

* 除了 HTTPS，直接存取閘道也會使用 WSS (WebSocket Secure) 通訊協定。因此，請確認防火牆和 Proxy 伺服器 (若您打算使用) 設定為允許傳出 WSS 連線。

### 啟用 Proxy 伺服器連線性

您可以按下列方式啟用或編輯 Proxy 伺服器連線性：

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 資料閘道 - 直接存取 中的說明重新啟動 [管理 Qlik 資料閘道 - 直接存取 服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) 服務。

   * 容器化安裝：

     重新啟動 direct-access-agent 容器。

### 停用 Proxy 伺服器連線性

您可以按下列方式關閉 Proxy 伺服器連線性：

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 資料閘道 - 直接存取 中的說明重新啟動 [管理 Qlik 資料閘道 - 直接存取 服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) 服務。

   * 容器化安裝：

     重新啟動 direct-access-agent 容器。

## 更新 Qlik Cloud 租用戶 URL

您可以按需要變更 Qlik Cloud 租用戶 URL。

要執行的操作：

1. 在直接存取閘道伺服器上，以管理員身分開啟命令提示字元並將工作目錄變更為 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 資料閘道 - 直接存取 中的說明重新啟動 [管理 Qlik 資料閘道 - 直接存取 服務](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) 服務。

資訊備註更新 Qlik Cloud 租用戶 URL 也需要您產生新的註冊金鑰，如 [第二階段：安裝或部署 直接存取閘道](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) 所述 (並進行註冊，如 [階段四：註冊資料閘道](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4) 所述)。

## 檢視目前的直接存取閘道伺服器設定

您可以檢視目前的 Direct Access gateway 伺服器設定。

要執行的操作：

1. 視您的安裝工作流程而定，請執行下列其中一項操作：

   * Windows 伺服器安裝：

     在直接存取閘道伺服器上，以管理員身分開啟命令提示字元並將工作目錄變更為 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 資料閘道 - 直接存取 服務

資訊備註僅適用於 Windows 伺服器安裝。

在直接存取閘道伺服器上變更設定後，您需要重新啟動 Qlik 資料閘道 - 直接存取 服務。您也可以在不同的帳戶之下執行服務。

### 開始、停止或重新啟動服務

在直接存取閘道伺服器上，進行下列事項之一以停止、啟動或重新啟動服務：

* 按需要開啟 Windows 服務主控台並停止、啟動或重新啟動 Qlik 資料閘道 - 直接存取 服務。

* 以管理員身分開啟命令提示字元並將工作目錄變更為 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)。然後執行下列命令：

  connectoragent service stop

  將會顯示伺服器已成功停止的確認。

  connectoragent service start

  將會顯示伺服器已成功啟動的確認。

### 在不同的帳戶之下執行服務

依預設，Qlik 資料閘道 - 直接存取 服務會在本機系統帳戶之下執行。若要在不同的帳戶之下執行服務，用滑鼠右鍵按一下 Windows 服務主控台中的 Qlik 資料閘道 - 直接存取 並選取登入索引標籤。然後選取此帳戶並輸入帳戶詳細資料。完成後，儲存設定並重新啟動服務。

## 可用的命令類別

若要查看可用命令類別清單：

1. 視您的安裝工作流程而定，請執行下列其中一項操作：

   * Windows 伺服器安裝：

     以管理員身分開啟命令提示字元並將工作目錄變更為 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)。

   * 容器化安裝：

     在 direct-access-agent 容器內開啟主控台。

2. 根據您的安裝工作流程，執行下列其中一個指令：

   * Windows 伺服器安裝：

     connectoragent help

   * 容器化安裝：

     dotnet ConnectorAgent.dll help

將會顯示下列清單：

* service - 請參閱上面的管理 Qlik 資料閘道 - 直接存取 服務。

* qcs - 必須先於所有記錄的命令，服務命令除外。

  範例 (Windows 伺服器安裝)：

  connectoragent qcs show\_config

  範例 (容器化安裝)：

  dotnet ConnectorAgent.dll qcs show\_config

* setup - 僅供支援使用。

* repository - 僅供支援使用。

* configuration - 僅供支援使用。