Linux 版 Tableau Server 說明

未經授權的代理程式（嚴重）

不相容的代理程式版本（嚴重）

代理訊息佇列憑證變換失敗（嚴重）

代理程式停機（警告）

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

未經授權的代理程式

未經授權的代理程式事件會由系統記錄為嚴重事件，只要我們偵測到您的 Tableau Server 未經正確授權使用 Tableau Resource Monitoring Tool 就會如此記錄。

若要使用 Resource Monitoring Tool 監視您的 Tableau Server，您的 Tableau Server 必須獲得 Tableau Advanced Management 的授權。

代理程式將不再於未授權狀態下收集資料，也不再傳送資料至 RMT 伺服器。不過，您可以繼續看到先前當環境經正確授權時所收集的資料。

若要解決此問題，需使用 Advanced Management 授權 Tableau Server。有關詳情，請參閱关于 Tableau Server 中的 Tableau Advanced Management 。

附註：將有效授權新增至 Tableau Server 後，最多可能需要一個小時才會清除事件。

還有其他原因可能導致 Agents Unlicensed 事件：

• Tableau Server API 認證可能不正確。在環境設定頁面中，確認使用者名稱和密碼正確無誤，以及所使用的帳戶在 Tableau Server 上具有伺服器管理員角色。

• 無法連線至 Tableau Server REST API。確認已在 Tableau Server 上啟用 REST API，且 Tableau Server 執行中。

  若要解決 REST API 連線問題，請從「Admin」功能表中選擇「Environments」，對要修改的環境按一下「Edit Environment」，在「Environment Details」索引標籤中，按一下頁面右側「Tableau Server REST API」部分中的「Test Connection」按鈕。

• RMT 伺服器無法連線到 Tableau Server，可能是因為網路連線或類似問題。

不相容的代理程式版本

當環境中的一或多個代理程式版本 RMT 伺服器版本不相容時，代理程式不相容事件將被記錄為嚴重事件。

要解決此問題，需要確保代理程式的版本與當前 RMT 伺服器版本相容。

請使用以下任一步驟來解決這個問題：

• 如果代理程式的版本早於最低相容版本，則必須至少將代理程式升級到事件報告中列出的最低相容版本。
• 如果代理程式的版本高於 RMT 伺服器版本，我們建議您也將 RMT 伺服器升級到相同的更高版本。您可能需要升級其他代理程式，具體取決於它們當前所在的版本。

升級代理程式：

使用以下步驟來升級代理程式：

升級 RMT 伺服器

如果一或多個代理程式在更高版本上，請升級 RMT 伺服器。

使用以下步驟來升級 RMT 伺服器：

1. 複製新版本 RMT 伺服器套件至安裝 RMT 伺服器的機器。

2. 使用以下命令在 RMT 伺服器上停止 Resource Monitoring Tool：

   rmtadmin stop --master

3. 使用以下命令停止所有 Tableau 伺服器節點上的 Resource Monitoring Tool 代理程式：

   rmtadmin stop --agent

4. 停止服務後，最佳做法是檢查是否有任何 Resource Monitoring Tool 流程在停止服務後執行：即名稱中包含 tabrmt-agent 或 tabrmt-master 的任何流程。這未包含 PostgreSQL 或 RabbitMQ。可以使用以下命令檢查狀態：

   rmtadmin status

5. 在 RMT 伺服器上執行升級命令。這會將現有版本升級到新版本：

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

   sudo yum install <pathtomasterserverinstaller>/<tabrmt-master-setup-<version>-x86_64.rpm>

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

   對於 Ubuntu 和 Debian 發行版：

   若要從版本 2020.4 升級到 2020.4.1 或更高版本：

   touch /tmp/tabrmt-master-upgrading.txt && sudo apt install <tabrmt-master-setup-<version>-amd_64.deb>

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

   附註：僅當從 2020.4 升級時才需要 touch 命令。若在安裝套件之前未執行 touch 命令，請在升級之前解除安裝現有版本的 Resource Monitoring Tool。

   若要從版本 2020.4.1 升級到 2020.4.2 或更高版本：

   sudo apt install <pathtomasterserverinstaller>/<tabrmt-master-setup-<version>-amd_64.deb>

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

6. 確認代理程式和 RMT 伺服器都在執行中。如果代理程式和 RMT 伺服器在升級完成後並未自動重新啟動，請自行啟動代理程式和主要服務。

代理訊息佇列憑證變換失敗

從版本 2021.3 開始，作為安全性最佳作法，代理程式和 Rabbit MQ 之間的連線憑證必須是該代理程式的唯一憑證。唯一憑證是在新安裝期間建立或在升級到 2021.3 時更新的。

在升級過程中，如果出現網路問題，憑證更新過程可能會失敗，從而導致出現嚴重事件報告。但是，這不會中斷升級過程，升級過程將繼續。升級完成後， Resource Monitoring Tool 將每天重試以建立唯一憑證。為初始失敗和隨後每次失敗的重試建立嚴重事件報告。在此期間，代理程式將繼續使用以前的憑證工作，直到建立新憑證。

問題可能會自行解決，但如果問題仍然存在，請執行以下動作：

• 驗證代理程式是否可以連線到 RMT 伺服器。

• 檢查代理程式和 RMT 伺服器之間的防火牆問題。

代理程式停機

當 Tableau Resource Monitoring Tool 無法與 Tableau Server 上的代理程式通訊時，系統會將代理程式停機事件記錄為警告。

請使用下列步驟來疑難排解這個問題：

1. 確保託管代理的硬體正在執行並且可用於與 RMT 伺服器通訊。
2. 確保代理程式服務已成功註冊並正在執行。您可以巡覽到「管理」->「環境」->「編輯環境」->「伺服器」索引標籤來查看 Tableau 伺服器節點的完整清單和代理的狀態。

代理程式輪詢和事件建立時間

• 代理程式每 5 分鐘向 Resource Monitoring Tool 伺服器傳送一次活動訊號訊息。
• Resource Monitoring Tool 伺服器檢查來自代理程式的最新活動訊號訊息是否小於 15 分鐘。
  • 如果從代理程式收到的最新活動訊號訊息時間小於 15 分鐘，則視為代理程式在線並且不會建立任何事件，並且會清除任何現有的代理程式關閉。
  • 如果從代理程式收到的最新活動訊號訊息時間超過 15 分鐘，則視為是第一次嘗試失敗。此後的每一分鐘，都會進行一次檢查，再進行兩次。如果在三次嘗試（第一次嘗試和兩次重試）後仍然沒有最近的活動訊號訊息，則建立代理程式關閉事件。

  附註：根據上述輪詢間隔，代理程式離線後大約需要17（15+1+1）分鐘才能建立代理程式關閉事件。

誰可以執行此動作

Resource Monitoring Tool 管理員或具備伺服器/環境管理角色的 Resource Monitoring Tool 使用者。