使用命令列安裝代理程式

套用到： Tableau Advanced Management

代理程式是一個輕量程序，會消耗最少的伺服器資源，並將資料傳送至 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，安裝程式便會失敗。

       

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

  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 使用者身分登入，以便可以執行 rtmadmin 命令，該命令始終要求以 tabrmt-agent 使用者身分執行。另外，再次登入後會建立一個群組成員身分變更已生效的新工作階段。

      sudo su --login tabrmt-agent

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

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --agent-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>.json

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

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

      否

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

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

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

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

誰可以執行此動作

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

Windows：

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

Linux：

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

後續步驟

設定 Tableau Resource Monitoring Tool

返回頂端
感謝您的意見反應！已成功提交您的意見回饋。謝謝！