使用命令列安裝 RMT 伺服器

Resource Monitoring Tool 伺服器(RMT 伺服器)託管使用者與其互動的 Web 應用程式。也會執行大部分的背景處理工作,以彙整和監視代理程式傳來的資料。RMT 伺服器必須安裝在專用硬體上。

本主題介紹使用命令列安裝 RMT 伺服器的步驟。Windows 和 Linux 作業系統都支援命令列安裝。

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

要安裝 RMT 伺服器:

  1. 執行 RMT 伺服器安裝程式:
    1. 下載 RMT 伺服器安裝程式,將其儲存到您可以從計畫安裝 RMT 伺服器的電腦上存取的位置。

    2. 以管理員身分開啟命令提示字元。

    3. 導航到 RMT 伺服器安裝程式的位置,並使用以下命令執行 exe 檔

      Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1

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

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

      Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1 InstallFolder="D:\Tableau Resource Monitoring Tool\master"

      所有安裝命令屬性與開關的完整清單可在下方本區段找到。

    這會安裝封包,必要條件包括 RabbitMQ、Erlang 和 PostgreSQL 資料庫。PostgreSQL 資料庫用於儲存從 Tableau Server 收集的使用情況資料。接著它才會繼續安裝 RMT 伺服器。

  2. 設定 RMT 伺服器:
    1. 執行以下命令並提供選項:

      rmtadmin master-setup [options]

      設定選項可以透過命令提示(組態檔)提供。如果未提供選項,除了管理員密碼外,將套用預設值。管理員使用者名稱將設定為 admin,系統將提示您提供密碼。

      包括所需的密碼參數的範例命令:

      rmtadmin master-setup --admin-username=<name the administrator user> --admin-password=<administrator user password>

      下表列出了用於設定 RMT 伺服器的條件和一些常用選項。有關設定選項的完整清單,請參閱 rmtadmin 命令列公用程式

      附註:需要 HTTPS 選項可確保 RMT 伺服器和使用者之間的安全通訊。當您需要 HTTPS 進行通訊時,還必須為這些通訊使用的憑證選擇一種模式。以下表格包括各種選項。若要深入瞭解有關這些模式和憑證,請參閱SSL 憑證模式和要求

      選項是否為必要項目?預設值說明
      admin-password

      密碼可以在命令列中提供,也可以提供包含密碼的檔案以供使用。若兩者均未提供,系統會提示您輸入密碼。

      不適用管理員使用者的密碼。
      admin-password-file

      密碼可以在命令列中提供,也可以提供包含密碼的檔案以供使用。若兩者均未提供,系統會提示您輸入密碼。

      不適用管理員使用者的密碼儲存的檔案。
      admin-usernameadmin管理員使用者的使用者名稱。
      http-port80 
      require-httpsFalse如果為 True,http 不可用。

      如果為 False,http 將轉送到 https。
      https-certificate-mode

      「預設」

      可用選項:

      • 預設值
      • 存放區
      • 本機

      為 HTTPS 憑證執行的憑證類型搜尋。

      預設值:此模式使用安裝程式提供的預設自我簽署憑證。

      儲存:可在 Windows 憑證儲存區中輸入憑證的指紋。

      本機:允許您在 config 資料夾中指定檔案型憑證。

      https-certificate-store-thumbprintNull在「儲存」憑證模式下要搜尋的 HTTPS 憑證雜湊/ 指紋。
      https-certificate-local-name

      Null

      附註:若未指定,Resource Monitoring Tool會使用自我簽署憑證進行安裝,並將使用該憑證進行 HTTPS 通訊。

      不含副檔名的 HTTPS 憑證檔案的名稱。
      https-certificate-local-passwordNullHTTPS 憑證的密碼。
      https-certificate-local-password-fileNull包含 HTTPS 憑證密碼的檔案路徑。
  3. 建立環境:

    1. 執行以下命令即可建立環境:

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      使用此命令可用的選項設定環境。以下是一些需要考量的關鍵組態選項:

      • Tableau Server REST API 和 Tableau Server 存放庫組態會用於與 Tableau Server 進行通訊。Tableau Server 存放庫為選用組態,但也是存取 Tableau Server 的首選方法。
      • RMT 連線到 Tableau Server 存放庫時,可以選擇設定安全的加密連線。為在 RMT 和 Tableau Server 存放庫資料庫之間使用 SSL 連線,必須將 Tableau Server 設定為使用 SSL。有關詳情,請參閱針對內部 Postgres 通訊設定 SSL

      下表列出了一些常用選項。有關選項的完整清單,請參閱 rmtadmin 命令列公用程式

      選項是否為必要項目?預設值說明
      --name不適用環境的名稱。
      --gateway-url

       

      不適用

      用於存取 Tableau Server 閘道的 URL。

      --version不適用此環境將監控的 Tableau Server 版本。
      --api-usernameNull用於連接 Tableau Server API 的帳戶使用者名稱。使用者帳戶應該是可以存取所有 Tableau Server 網站的 Tableau Server 管理員。
      --api-password

      (如果指定 Tableau API 使用者名稱,則需提供密碼,或指定檔案路徑和具有密碼的檔案)

      Null

      用來連接 Tableau Server API 的 Tableau Server API 使用者帳戶密碼。

      --admin-password-fileNull檔案的路徑和包含 Tableau Server API 使用者帳戶密碼的檔案名稱。
      --repository-server

      Null

      這是隨 Tableau Server 安裝的 PostgreSQL 資料庫的伺服器名稱。
      --repository-portNullTableau Server 存放庫資料庫的連接埠號碼。
      --repository-usernameNull

      用於連線到隨 Tableau Server 存放庫安裝的 PostgreSQL 資料庫的使用者名稱。

      基於效能考量,Resource Monitoring Tool 要直接存取 Tableau Server 存放庫資料庫。為求順利使用,必須啟用存放庫存取,並為唯讀資料庫使用者設定密碼。有關詳情,請參閲啟用對 Tableau Server 存放庫的存取

      --repository-passwordNull

      用於連線到隨 Tableau Server 安裝的 PostgreSQL 資料庫的使用者帳戶密碼。

      基於效能考量,Resource Monitoring Tool 要直接存取 Tableau Server 存放庫資料庫。為求順利使用,必須啟用存放庫存取,並為唯讀資料庫使用者設定密碼。有關詳情,請參閲啟用對 Tableau Server 存放庫的存取

      --repository-password-fileNull包含檔案名稱的路徑,其中具有使用者帳戶的密碼,用於連線到隨 Tableau Server 安裝的 PostgreSQL 資料庫。
      --repository-ssl-mode

      偏好

      Tableau Server 存放庫 SSL 模式:

      偏好SSL 或需要SSL 來設定 SSL 連線到 Tableau 存放庫。

      禁用來禁止使用 SSL 連線到 Tableau Server 存放庫。

      --repository-ssl-thumbprint

      Null可以選擇提供 Tableau Server 產生的指紋,或將 server.crt 檔案複製到「Resource Monitoring Tool 伺服器」(RMT 伺服器) 電腦。若選擇複製憑證檔案,則不必提供指紋。有關詳情,請參閱設定 Postgres SSL 以允許從用戶端直接連線
    2. 下載啟動程式檔案到可從 Tableau Server 節點存取的位置。

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

 

Windows 安裝屬性和開關

開關:

參數說明註解
/install | /uninstall執行設定以安裝或解除安裝 Resource Monitoring Tool

預設為安裝、顯示 UI 及所有提示。若未使用全新安裝上的 InstallFolder 屬性指定目錄,則假設 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master。如果已安裝 Resource Monitoring Tool,安裝程式會使用與目前安裝相同的位置。

要完全移除包括資料目錄的 Resource Monitoring Tool,請使用 /uninstall DELTEDATADIR=1

/passive以最基本的 UI 且不出現提示來執行安裝程式。 
/quiet | /silent以無人參與的完全無提示模式執行安裝程式。不會顯示 Web 介面或提示。/quiet 或 /silent 擇一使用,請勿同時使用。
/norestart即使不需要重新啟動,也可以在不重新啟動 Windows 的情況下,執行安裝程式。在某些極少數情況下,即便使用此選項,也無法禁止重新啟動。這很可能是在跳過較早系統重新啟動。例如,在安裝其他軟體期間跳過了重新啟動。
/log <log-file>將資訊記錄到指定的檔案和路徑。預設情況下,會在 %TEMP% 中建立記錄檔,其命名慣例為 Tableau_Resource_Monitoring_Tool_<version_code>。

若未指定檔案位置,則記錄檔會寫入至使用者的「TEMP」資料夾 - C:\Users\<username>\AppData\Local\Temp。安裝之後,請檢查此記錄檔中是否有錯誤。

例如:<Setup file> /quiet /log="C:\Tableau\Logs\RmtInstall

屬性:

屬性說明註解
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\master

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

要安裝 RMT 伺服器:

  1. 安裝 RMT 伺服器:

    1. 下載 rpm 或 .deb RMT 伺服器安裝程式,將其儲存到您可以從計畫安裝 RMT 伺服器的電腦上存取的位置。

    2. 以具有 sudo 存取權限的使用者身分,登入要安裝 RMT 伺服器的電腦。

    3. 執行以下命令以安裝 RMT 伺服器,其中 <version> 的格式為 major-minor-maintenance:

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

      sudo yum install <path/to/rmtserverinstaller>/Tabrmt-Master-x86_64-<version>.rpm

      對於 Ubuntu 發行版:

      sudo apt install ./ <path/to/rmtserverinstaller>/Tabrmt-Master-amd64-<version>.deb

    這會安裝封包,必要條件包括 RabbitMQ、Erlang 和 PostgreSQL 資料庫。PostgreSQL 資料庫用於儲存從 Tableau Server 收集的使用情況資料。接著它才會繼續安裝 RMT 伺服器。

  2. 初始化 RMT 伺服器:

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

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

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

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

  3. 設定 RMT 伺服器:
    1. tabrmt-master使用者身分執行以下命令:

      sudo su --login tabrmt-master

      rmtadmin master-setup [options]

      可以透過命令提示字元資源或組態檔提供該設定選項。如果未提供選項,則套用預設值,管理員密碼除外。會將管理員使用者名稱設定為 admin,會提示您提供密碼。

      包括所需的密碼參數的範例命令:

      rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>

      下表列出了用於設定 RMT 伺服器的條件和一些常用選項。有關設定選項的完整清單,請參閱 rmtadmin 命令列公用程式

      附註:需要 HTTPS 選項可確保 RMT 伺服器和使用者之間的安全通訊。當您需要 HTTPS 進行通訊時,還必須為這些通訊使用的憑證選擇一種模式。以下表格包括各種選項。若要深入瞭解有關這些模式和憑證,請參閱安裝 Tableau Resource Monitoring Tool

      選項是否為必要項目?

      預設值

      說明
      admin-password

      密碼可以在命令列中提供,也可以提供包含密碼的檔案以供使用。若兩者均未提供,系統會提示您輸入密碼。

      不適用管理員使用者的密碼。
      admin-password-file

      密碼可以在命令列中提供,也可以提供包含密碼的檔案以供使用。若兩者均未提供,系統會提示您輸入密碼。

      不適用

      管理員使用者的密碼儲存的檔案。

      附註:tabrmt-master 使用者必須有此檔案存取權。

      admin-usernameadmin管理員使用者的使用者名稱。
      http-port80 
      require-httpsFalse

      將 HTTP 流量重新導向 HTTPS。

      https-certificate-mode

      可用選項:

      • 預設值
      • 本機

      為 HTTPS 憑證執行的憑證類型搜尋。

      預設值:此模式使用安裝程式提供的預設自我簽署憑證。

      本機:此模式允許您指定 <installation directory>\config 資料夾中檔案型的憑證。預設位置為:C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config

      https-certificate-local-name

      附註:若未指定,Resource Monitoring Tool會使用自我簽署憑證進行安裝,並將使用該憑證進行 HTTPS 通訊。

      Null不含副檔名的 HTTPS 憑證檔案的名稱。
      https-certificate-local-passwordNullHTTPS 憑證的密碼。
      https-certificate-local-password-fileNull包含 HTTPS 憑證密碼的檔案路徑。
  4. 建立環境:

    1. 執行以下命令即可建立環境:

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      使用此命令可用的選項設定環境。以下是一些需要考量的關鍵組態選項:

      • Tableau Server REST API 和 Tableau Server 存放庫組態會用於與 Tableau Server 進行通訊。Tableau Server 存放庫為選用組態,但也是存取 Tableau Server 的首選方法。
      • RMT 連線到 Tableau Server 存放庫時,可以選擇設定安全的加密連線。為在 RMT 和 Tableau Server 存放庫資料庫之間使用 SSL 連線,必須將 Tableau Server 設定為使用 SSL。有關詳情,請參閱針對內部 Postgres 通訊設定 SSL

      下表列出了一些常用選項。有關選項的完整清單,請參閱 rmtadmin 命令列公用程式

      選項是否為必要項目?預設值說明
      --name不適用環境的名稱。
      --gateway-url

       

      不適用

      用於存取 Tableau Server 閘道的 URL。

      --version不適用此環境將監控的 Tableau Server 版本。
      --api-usernameNull用於連接 Tableau Server API 的帳戶使用者名稱。使用者帳戶應該是可以存取所有 Tableau Server 網站的 Tableau Server 管理員。
      --api-password

      (如果指定 Tableau API 使用者名稱,則需提供密碼,或指定檔案路徑和具有密碼的檔案)

      Null

      用來連接 Tableau Server API 的 Tableau Server API 使用者帳戶密碼。

      --admin-password-fileNull檔案的路徑和包含 Tableau Server API 使用者帳戶密碼的檔案名稱。
      --repository-server

      Null

      這是隨 Tableau Server 安裝的 PostgreSQL 資料庫的伺服器名稱。
      --repository-portNullTableau Server 存放庫資料庫的連接埠號碼。
      --repository-usernameNull

      用於連線到隨 Tableau Server 存放庫安裝的 PostgreSQL 資料庫的使用者名稱。

      基於效能考量,Resource Monitoring Tool 要直接存取 Tableau Server 存放庫資料庫。為求順利使用,必須啟用存放庫存取,並為唯讀資料庫使用者設定密碼。有關詳情,請參閲啟用對 Tableau Server 存放庫的存取

      --repository-passwordNull

      用於連線到隨 Tableau Server 安裝的 PostgreSQL 資料庫的使用者帳戶密碼。

      基於效能考量,Resource Monitoring Tool 要直接存取 Tableau Server 存放庫資料庫。為求順利使用,必須啟用存放庫存取,並為唯讀資料庫使用者設定密碼。有關詳情,請參閲啟用對 Tableau Server 存放庫的存取

      --repository-password-fileNull包含檔案名稱的路徑,其中具有使用者帳戶的密碼,用於連線到隨 Tableau Server 安裝的 PostgreSQL 資料庫。
      --repository-ssl-mode

      偏好

      Tableau Server 存放庫 SSL 模式:

      偏好SSL 或需要SSL 來設定 SSL 連線到 Tableau 存放庫。

      禁用來禁止使用 SSL 連線到 Tableau Server 存放庫。

      --repository-ssl-thumbprint

      Null可以選擇提供 Tableau Server 產生的指紋,或將 server.crt 檔案複製到「Resource Monitoring Tool 伺服器」(RMT 伺服器) 電腦。若選擇複製憑證檔案,則不必提供指紋。有關詳情,請參閱設定 Postgres SSL 以允許從用戶端直接連線
    2. 下載啟動程式檔案到可從 Tableau Server 節點存取的位置。

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

  5. 選用步驟 ─ 只在不使用 SSD 時 :預設情況下,針對 SSD 進行 Resource Monitoring Tool 最佳化。如果未使用 SSD 硬體,請執行以下命令:

    sudo /opt/tableau/tabrmt/master/tabrmt-master optimize --no-ssd

     

誰可以執行此動作

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

Windows

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

Linux

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

後續步驟

使用命令列安裝代理程式

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