---
schema_version: "1"
id: aaa7a9a60652fff6c86acb3babf2043a0ebcd5f6906d0f2fae24b9c5d74ebe0b
title: 使用命令列安裝代理程式
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server-linux/rmt-admin-agent-install-cli.md
canonical_url: https://help.tableau.com/current/server-linux/zh-tw/rmt-admin-agent-install-cli.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b242b9ab08e93f876ff0d53eda8d69e4a66409dfce5b03e5a485b62ff117ab82
description: Install the Resource Monitoring Tool Agent using the command line.
---
[跳至主要內容](#main-content)

# 使用命令列安裝代理程式

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

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

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

## 安裝之前

- 下載啟動程序檔案並將其儲存到要安裝 RMT 代理程式的節點可以存取的位置。**啟動程序檔案僅在下載後 24 小時內有效。如果欲使用的啟動程序檔案已下載超過 24 小時，將需要重新產生啟動程序檔案。**
- 代理程式註冊需要透過 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 代理程式初始化指令碼選項](https://help.tableau.com/current/server-linux/zh-tw/rmt-install-init-agent-opts.htm#RMTServerInitOpts)。
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>.`
        
        下表列出了用於註冊代理程式的設定選項：
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>選項</th><th>是否為必要項目？</th><th>預設值</th><th>描述</th></tr></thead><tbody><tr><td>--啟動程序檔案</td><td>是</td><td>&lt;無&gt;</td><td>啟動程序檔案的位置。</td></tr><tr><td>--username</td><td>是</td><td>&lt;無&gt;</td><td>這通常是您在 RMT 伺服器安裝期間建立的管理員使用者。</td></tr><tr><td>--password</td><td>是</td><td>&lt;無&gt;</td><td>這是使用者帳戶的密碼</td></tr><tr><td>---password-file</td><td><p>否</p><p>密碼可以在命令列中提供，也可以提供包含密碼的檔案。如果未提供任何一種，系統會提示您輸入密碼。</p></td><td>&lt;無&gt;</td><td>包含存著密碼檔名的路徑。</td></tr><tr><td>--server-name</td><td>否</td><td>電腦的主機名稱</td><td>已安裝代理程式的電腦名稱。若未提供任何選項，則此欄位將預設為電腦的主機名稱。</td></tr><tr><td>--server-description</td><td>否</td><td>&lt;無&gt;</td><td>已安裝代理程式的電腦說明。若未提供任何選項，則此欄位將保留為空白。</td></tr></tbody></table>

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

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`
        
        > [!TIP]
        > 
        > **附註：**使用 /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>`
        
        下表列出了用於註冊代理程式的設定選項：
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>選項</th><th>是否為必要項目？</th><th><p>預設值</p></th><th>描述</th></tr></thead><tbody><tr><td>--啟動程序檔案</td><td>是</td><td>&lt;無&gt;</td><td>啟動程序檔案的位置。</td></tr><tr><td>--username</td><td>是</td><td>&lt;無&gt;</td><td>這通常是您在 RMT 伺服器安裝期間建立的管理員使用者。</td></tr><tr><td>--password</td><td>是</td><td>&lt;無&gt;</td><td>這是使用者帳戶的密碼</td></tr><tr><td>---password-file</td><td><p>否</p><p>密碼可以在命令列中提供，也可以提供包含密碼的檔案。如果未提供任何一種，系統會提示您輸入密碼。</p></td><td>&lt;無&gt;</td><td>包含存著密碼檔名的路徑。</td></tr><tr><td>--server-name</td><td>否</td><td>電腦的主機名稱</td><td>已安裝代理程式的電腦名稱。若未提供任何選項，則此欄位將預設為電腦的主機名稱。</td></tr><tr><td>--server-description</td><td>否</td><td>&lt;無&gt;</td><td>已安裝代理程式的電腦說明。若未提供任何選項，則此欄位將保留為空白。</td></tr></tbody></table>
        
        ### Windows 安裝屬性和開關
        
        **開關：**
        
        | 參數 | 描述 | 註解 |
        | --- | --- | --- |
        | `/passive` | 以最基本的 UI 且不出現提示來執行安裝程式。 |   |
        | `/quiet | /silent` | 以無人參與的完全無提示模式執行安裝程式。不會顯示 Web 介面或提示。 | /quiet 或 /silent 擇一使用，請勿同時使用。 |
        
        屬性：
        
        <table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>屬性</th><th>描述</th><th>註解</th></tr></thead><tbody><tr><td><code>InstallFolder=&lt;path\to\installation\directory&gt;</code></td><td>安裝到指定的非預設安裝位置。</td><td><p>指定用來安裝 RMT 的位置。若未使用，RMT 會安裝到 <i>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master</i>。</p><p>範例：<code>&lt;Setup file&gt; /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"</code></p></td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>接受使用者授權合約 (EULA)。初始和附加節點上的無訊息、無提示和被動安裝需要執行此動作。1 = true，接受 EULA，0 = false，不接受 EULA。</td><td>如果使用 /passive、/silent 或 /quie 時未包含在內，則安裝程式將無法以無提示形式執行。如果包含但設定為 0，安裝程式便會失敗。</td></tr></tbody></table>

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

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

## 誰可以執行此動作

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

**Windows：**

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

**Linux：**

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

## 後續步驟

[設定 Tableau Resource Monitoring Tool](https://help.tableau.com/current/server-linux/zh-tw/rmt-config-index-config.htm)