---
schema_version: "1"
id: 27753efda93f26f2c71cd7e5082f9807c88908fd3a5a8f8779077cdbc8983c23
title: 使用命令行安装代理
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/rmt-admin-agent-install-cli.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/rmt-admin-agent-install-cli.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 18ed4c8c6e93ff2a273c2496c30755c45e7ea1795b96dc5a4b6bfcc2c7d71efd
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. **安装：**
    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/v0.0/server-linux/zh-cn/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>--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>

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

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>--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>

### 在多节点 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/v0.0/server-linux/zh-cn/rmt-config-index-config.htm)