---
schema_version: "1"
id: b69a864c0a1a695a4bd519115b50afce8af1bf53f2dfaf1beb81a144107bb02c
title: 使用命令行安装代理
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server/rmt-admin-agent-install-cli.md
canonical_url: https://help.tableau.com/current/server/zh-cn/rmt-admin-agent-install-cli.htm
source_site: help.tableau.com
content_type: documentation
content_hash: fdd1def7f44617be3fc9fd45f8d39db813610a4ee0bf2ee6a427b96db40aeddc
description: Install the Resource Monitoring Tool Agent using the command line.
---
[跳转到主要内容](#main-content)

# 使用命令行安装代理

代理是一个轻量级进程，它占用的服务器资源最少，并将数据发送到 Resource Monitoring Tool Server (RMT Server)。在每个 Tableau Server 节点上安装 Resource Monitoring Tool 代理。若要安装和注册代理，请下载代理引导程序配置文件，并将其保存到可从 Resource Monitoring Tool 代理节点中访问的一个位置。

本主题介绍可以使用命令行安装 Resource Monitoring Tool 代理的步骤。Windows 和 Linux 操作系统都支持命令行安装。

为了与我们公司的平等价值观保持一致，我们在可能的情况下更改了非包容性术语。由于在某些地方更改术语可能会导致重大更改，因此我们保留现有术语：因此，您可能会继续在 CLI 命令和选项、安装文件夹、配置文件和其他实例中看到这些术语。有关详细信息，请参见[“关于 Tableau 帮助”](https://help.tableau.com/current/tableau/zh-cn/about-tableau-help.htm)。

## 安装之前

- 下载引导程序文件并将其保存到要安装 RMT 代理的节点可以访问的位置。**引导程序文件仅在下载后 24 小时内有效。如果您使用的引导程序文件超过 24 小时，您将需要重新生成引导程序文件。**
- 代理注册将需要通过 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"`
        
        > [!TIP]
        > 
        > **注意：**使用 /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>`
        
        下表列出了用于注册代理的配置选项：
        
        <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>--bootstrap file</td><td>是</td><td>&lt;无&gt;</td><td>引导程序文件的位置。</td></tr><tr><td>--username</td><td>是</td><td>&lt;无&gt;</td><td>这通常是您在 RMT Server 安装期间创建的管理员用户。</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 或 /quiet 时未包括此开关，则安装程序将无法以无提示形式运行。如果包含此属性但设置为 0，安装程序将失败</td></tr></tbody></table>

**安装和配置代理：**

1. **安装：**
    1. 下载 .rpm 或 .deb 代理安装程序，并将其保存到可以从计划安装代理的计算机上访问的位置。
    2. 运行以下命令以安装代理，其中 <version> 的格式为“主要-次要-维护”：
        
        对于类似于 RHEL 的发行版（包括 CentOS）：
        
        `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
    
    EULA 可在 `/opt/tableau/tabrmt/agent/docs` 文件夹中找到。
    
    从版本 2023.1 开始，您可以指定 RMT 使用的自定义运行身份帐户，以及其他配置选项。默认情况下，RMT 创建并使用一个名为 `rmt-agent` 的帐户以在其下运行。若要指定 RMT 代理使用的自定义运行身份帐户，请在运行初始化脚本时包括 `--unprivileged-user` 选项。有关 `initialize-rmt-agent` 脚本的所有可用开关的信息，请参见[RMT 代理初始化脚本选项](https://help.tableau.com/current/server/zh-cn/rmt-install-init-agent-opts.htm#RMTServerInitOpts)。
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`
        
        下表列出了用于注册代理的配置选项：
        
        <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>--bootstrap file</td><td>是</td><td>&lt;无&gt;</td><td>引导程序文件的位置。</td></tr><tr><td>--username</td><td>是</td><td>&lt;无&gt;</td><td>这通常是您在 RMT Server 安装期间创建的管理员用户。</td></tr><tr><td>--password</td><td>是</td><td>&lt;无&gt;</td><td>这是用户帐户的密码</td></tr><tr><td>&nbsp;</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>

### 在多节点 Tableau Server 上安装代理

在 Tableau Server 的每个节点上运行上述步骤。在 RMT Server 的 Web 界面上，您应该能够看到安装代理的所有节点。

## 谁可以执行此操作

为了安装 Resource Monitoring Tool，您必须具有以下所有各项：

**Windows：**

- 正在安装 Resource Monitoring Tool 的计算机上的管理员权限。
- Tableau Server 管理员站点角色。

**Linux：**

- 用于安装代理的用户帐户的完全 sudo 访问权限。

## 后续步骤

[配置 Tableau Resource Monitoring Tool](https://help.tableau.com/current/server/zh-cn/rmt-config-index-config.htm)