使用命令列安裝代理程式

代理程式是一個輕量程序,會消耗最少的伺服器資源,並將資料傳送至 Resource Monitoring Tool 伺服器(RMT 伺服器)。在每個 Tableau Server 節點上安裝 Resource Monitoring Tool 代理程式。若要安裝並註冊代理程式,請下載代理程式啟動程序組態檔案,並將其儲存到可從 Resource Monitoring Tool 代理程式節點存取的位置。

本主題會介紹可用於透過命令列安裝 Resource Monitoring Tool 代理程式的步驟。Windows 和 Linux 作業系統都支援命令列安裝。

為了致力於符合本公司平等的價值觀,我們盡可能變更了非包容性術語。由於在某些地方變更字詞可能會導致重大變更,因此我們保留現有字詞:因此,您可能會繼續在 CLI 命令和選項、安裝程式資料夾、組態檔和其他執行個體中看到這些術語。有關詳情,請參閱關於 Tableau 說明(連結在新視窗開啟)

安裝之前

  • 下載啟動程序檔案並將其儲存到要安裝 RMT 代理程式的節點可以存取的位置。啟動程序檔案僅在下載後 24 小時內有效。如果欲使用的啟動程序檔案已下載超過 24 小時,將需要重新產生啟動程序檔案。
  • 從版本 2021.3 開始,代理程式註冊將需要使用 https 端點和 RabbitMQ 進行通訊以完成代理程式註冊。確保連接埠 443 和 5672 都為這些通訊開啟。

若要安裝和設定代理程式:

  1. 下載啟動程式檔案到可從 Tableau Server 節點存取的位置。

    rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

  2. 執行代理程式安裝程式:
    1. 下載代理程式安裝程式,並將其儲存到可以從 Tableau Server 電腦存取的位置。

    2. 以管理員身分開啟命令提示字元。
    3. 巡覽到代理程式安裝程式的位置,然後使用以下命令執行 exe 檔案

      Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>

      從 2021.4 開始,必須為代理程式指定執行身分使用者帳戶。此帳戶用於存取 Tableau Server,以收集監視資訊。

      對於執行身分使用者帳戶,指定您目前用於 Tableau Server 使用者帳戶的相同帳戶。若提供的帳戶資訊與 Tableau Server 上的不同,代理程式將無法收集該節點上的監視資料。

      • 若 Tableau Server 設定為使用網路服務帳戶作為執行身分使用者,請使用 RUN_AS_NETWORK_SERVICE=1。
      • 若 Tableau Server 設定為使用自訂使用者,請使用 RUN_AS_USER_CUSTOM=1。使用與為 Tableau Server 指定的相同的帳戶認證。

      預設安裝資料夾通常如下所示:C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent。要提供不同的安裝位置,請執行以下命令:

      Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

      附註:使用 /silent 或 /quiet 開關可無人式執行設定,而不顯示任何 UI 或提示。

  3. 註冊代理程式:
    1. 執行以下命令,以註冊代理程式:

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>

      下表列出了用於註冊代理程式的設定選項:

      選項是否為必要項目?

      預設值

      說明
      --啟動程序檔案<無>啟動程序檔案的位置。
      --username<無>這通常是您在 RMT 伺服器安裝期間建立的管理員使用者。
      --password<無>這是使用者帳戶的密碼
      ---password-file

      密碼可以在命令列中提供,也可以提供包含密碼的檔案。如果未提供任何一種,系統會提示您輸入密碼。

      <無>包含存著密碼檔名的路徑。
      --server-name電腦的主機名稱已安裝代理程式的電腦名稱。若未提供任何選項,則此欄位將預設為電腦的主機名稱。
      --server-description<無>已安裝代理程式的電腦說明。若未提供任何選項,則此欄位將保留為空白。

      Windows 安裝屬性和開關

      開關:

      參數說明註解
      /passive以最基本的 UI 且不出現提示來執行安裝程式。 
      /quiet | /silent以無人參與的完全無提示模式執行安裝程式。不會顯示 Web 介面或提示。/quiet 或 /silent 擇一使用,請勿同時使用。

      屬性:

      屬性說明註解
      InstallFolder=<path\to\installation\directory>安裝到指定的非預設安裝位置。

      指定用來安裝 RMT 的位置。。若未使用,RMT 會安裝到 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master

      範例:<Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"

      ACCEPTEULA=1|0接受使用者授權合約 (EULA)。初始和附加節點上的無訊息、無提示和被動安裝需要執行此動作。1 = true,接受 EULA,0 = false,不接受 EULA。如果使用 /passive、/silent 或 /quie 時未包含在內,則安裝程式將無法以無提示形式執行。如果包含但設定為 0,安裝程式便會失敗。

       

在多節點 Tableau Server 上安裝代理程式

在 Tableau Server 的每個節點上執行上述步驟。在 RMT 伺服器的 Web 介面上,應該能夠看到已安裝代理程式的所有節點。

誰可以執行此動作

如要安裝 Resource Monitoring Tool,您必須具備以下所有條件:

Windows:

  • 在您安裝 Resource Monitoring Tool 的電腦上有管理員權限。
  • Tableau Server 管理員站台角色。

Linux:

  • 為用來安裝代理程式的使用者帳戶提供完整的 sudo 存取權。

後續步驟

設定 Tableau Resource Monitoring Tool