使用命令列安裝代理程式

代理程式是一個輕量程序,會消耗最少的伺服器資源,並將資料傳送至 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. 安裝:
    1. 下載 .rpm 或 .deb 代理程式安裝程式,然後將其儲存到可以從計劃安裝代理程式的電腦上存取的位置。

    2. 執行以下命令,以安裝 <版本> 格式為 major-minor-maintenance 的代理程式:

      對於包括 CentOS 的類 RHEL 發行版:

      sudo yum install Tabrmt-Agent-x86_64-<version>.rpm

      對於 Ubuntu:

      sudo apt install Tabrmt-Agent-amd64-<version>.deb

  2. 初始化 RMT 代理程式:

    初始化 RMT 代理程式時,必須明確接受使用者授權合約 (EULA)。還可以選擇指定非預設設定。要使用預設設定初始化 RMT 代理程式,請執行以下命令:

    sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula

    可以在 /opt/tableau/tabrmt/agent/docs 資料夾中找到使用者授權合約。

    從版本 2023.1 開始,可以指定 RMT 使用的自訂執行方式帳戶,以及其他設定選項。預設情況下,RMT 建立並使用名為 rmt-agent 的帳戶執行。要指定 RMT 代理程式使用的自訂執行方式帳戶,請包含 --unprivileged-user 執行初始化指令碼時的選項。有關 initialize-rmt-agent 指令碼所有可用切換的詳情,請參閱 RMT 代理程式初始化指令碼選項

  3. 註冊:
    1. 登出並以 tabrmt-agent 使用者身分登入,以便可以執行 rmtadmin 命令,該命令始終要求以 tabrmt-agent 使用者身分執行。另外,再次登入時,將會建立一個群組成員身分變更已生效的新工作階段。

      sudo su --login tabrmt-agent

    2. 執行以下命令,並提供啟動程序檔案所在的路徑。提供要安裝代理程式的節點說明。

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

      此時會提示輸入 RMT 管理使用者的密碼。

      附註:預設情況下,tabrmt-agent 使用者會從基本工作目錄:/var/opt/tableau/tabrmt/agent 執行命令,因此必須相應地指定檔案路徑。例如,若按照建議將啟動程序檔案放在 /var/opt/tableau/tabrmt/agent/bootstrap/ 資料夾中,則檔案路徑為 /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.

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

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

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

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

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

  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

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

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

      Tabrmt-Agent-64bit-<version>.exee /silent ACCEPTEULA=1 InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

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

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description>

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

      選項是否為必要項目?

      預設值

      說明
      --啟動程序檔案<無>啟動程序檔案的位置。
      --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

感謝您的意見反應!已成功提交您的意見回饋。謝謝!