管理 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 資料閘道 - 直接存取 服務 服務。

   • 容器化安裝：

     重新啟動 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 資料閘道 - 直接存取 服務 服務。

   • 容器化安裝：

     重新啟動 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 資料閘道 - 直接存取 服務 服務。

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

您可以檢視目前的 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 資料閘道 - 直接存取 服務

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

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

依預設，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 - 僅供支援使用。