使用命令行安装 RMT Server
Resource Monitoring Tool Server(RMT Server) 承载用户与之交互的 Web 应用程序。它还可以进行大量的后台处理,对代理中的数据进行排序和监视。RMT Server 必须安装在专用硬件上。
本主题介绍可以使用命令行安装 RMT Server 的步骤。Windows 和 Linux 操作系统都支持命令行安装。
为了与我们公司的平等价值观保持一致,我们在可能的情况下更改了非包容性术语。由于在某些地方更改术语可能会导致重大更改,因此我们保留现有术语:因此,您可能会继续在 CLI 命令和选项、安装文件夹、配置文件和其他实例中看到这些术语。有关详细信息,请参见“关于 Tableau 帮助”(链接在新窗口中打开)。
若要安装 RMT Server,请执行以下操作:
安装 RMT Server:
下载 rpm 或 .deb RMT Server 安装程序,并将其保存到可以从计划安装 RMT Server 的计算机上访问的位置。
登录到希望在其中以具有 sudo 访问权限的用户身份安装 RMT Server 的计算机。
运行以下命令以安装 RMT Server,其中 <version> 的格式为“主要-次要-维护”:
对于类似于 RHEL 的发行版(包括 CentOS):
sudo yum install <pathtormtserverinstaller>/Tabrmt-Master-x86_64-<version>.rpm
对于 Ubuntu 发行版:
sudo apt install ./<pathtormtserverinstaller>/Tabrmt-Master-amd_64-<version>.deb
这将安装软件包和必备组件,包括 RabbitMQ、Erlang 和 PostgreSQL 数据库。PostgreSQL 数据库用于存储从 Tableau Server 收集的使用情况数据。然后,它将继续安装 RMT Server。
初始化RMT Server:
初始化 RMT Server 时,您必须明确接受最终用户许可协议 (EULA)。您还可以选择指定非默认配置。若要使用默认配置初始化 RMT Server,请运行以下命令:
sudo /opt/tableau/tabrmt/master/install-scripts/initialize-rmt-master --accepteula
EULA 可在
/opt/tableau/tabrmt/master/docs
文件夹中找到。从版本 2023.1 开始,您可以指定 RMT 使用的自定义运行身份帐户,以及其他配置选项。默认情况下,RMT 创建并使用一个名为
rmt-master
的帐户以在其下运行。若要指定 RMT Server 使用的自定义运行身份帐户,请在运行初始化脚本时包括--unprivileged-user
选项。有关initialize-rmt-master
脚本的所有可用开关的信息,请参见RMT Server 初始化脚本选项。- 配置 RMT Server
以
tabrmt-master
用户身份运行以下命令:sudo su --login tabrmt-master
rmtadmin master-setup [options]
配置选项可以通过命令提示符(配置文件)提供。如果未提供选项,则会应用除管理员密码外的默认值。管理员用户名将设置为 admin,并将提示您提供密码。
示例命令,包括所需的 password 参数:
rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>
下表列出了用于配置 RMT Server 所需的选项和一些常用选项。有关配置选项的完整列表,请参见rmtadmin 命令行实用工具。
注意:需要 HTTPS 选项来确保 RMT Server 和用户之间的安全通信。当您需要 HTTPS 进行通信时,还必须为应该用于这些通信的证书选择一种模式。下表包括各种选项。若要详细了解这些模式和证书,请参见SSL 证书模式和要求。
选项 是否必需? 默认
描述 admin-password 是
密码可以在命令行中提供,也可以提供包含要使用的密码的文件。如果未提供任何一项,系统将提示您输入密码。
不适用 管理员用户的密码。 admin-password-file 否
密码可以在命令行中提供,也可以提供包含要使用的密码的文件。如果未提供任何一项,系统将提示您输入密码。
不适用 存储管理员用户密码的文件。
注意:
tabrmt-master
用户必须有权访问此文件。admin-username 否 admin 管理员用户的用户名。 http-port 否 80 require-https 否 False 将 http 流量重定向到 HTTPS。 https-certificate-mode 否 "Default"
可用选项:
默认
本地
要对 HTTPS 证书执行的证书搜索的类型。
默认:此模式使用安装程序提供的默认自签名证书。
本地:允许您在 /var/opt/tableau/tabrmt/master/config 文件夹中指定基于文件的证书。
https-certificate-local-name 否
注意:如果未指定,Resource Monitoring Tool 安装时将附带自签名证书,并将使用该证书进行 HTTPS 通信。
Null 不带文件扩展名的 HTTPS 证书文件的名称。 https-certificate-local-password 否 Null 用于 HTTPS 证书的密码。 https-certificate-local-password-file 否 Null 包含用于 HTTPS 证书的密码的文件的路径。
创建环境
运行以下命令以创建环境:
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-username 否 Null 用于连接到 Tableau Server API 的帐户的用户名。用户帐户应该是可以访问所有 Tableau Server 站点的 Tableau Server 管理员。 --api-password 否
(如果您指定 Tableau API 用户名,您将提供密码,或指定文件路径和包含密码的文件)
Null
用于连接到 Tableau Server API 的 Tableau Server API 用户帐户的密码。
--api-password-file 否 Null 文件的路径和包含 Tableau Server API 用户帐户密码的文件的名称。 --repository-server 是 Null
这是与 Tableau Server 一起安装的 PostgreSQL 数据库的服务器名称 --repository-port 是 Null Tableau Server 存储库数据库的的端口号。 --repository-username 是 Null 用于连接到随 Tableau Server 存储库一起安装的 PostgreSQL 数据库的用户名。
出于性能原因,Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点,必须启用对存储库的访问,并为 readonly 数据库用户设置密码。有关详细信息,请参见启用对 Tableau Server 存储库的访问。
--repository-password 是 Null 用于连接到随 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户的密码。
出于性能原因,Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点,必须启用对存储库的访问,并为 readonly 数据库用户设置密码。有关详细信息,请参见启用对 Tableau Server 存储库的访问。
--repository-password-file 否 Null 包含用于连接到与 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户密码所在文件名的路径。 --repository-ssl-mode 否
首选 Tableau Server 存储库 SSL 模式:
选择“首选SSL”或“需要 SSL”以配置与 Tableau 存储库的 SSL 连接。
选择“禁用”以从不使用 SSL 建立 Tableau Server 存储库连接。
--repository-ssl-thumbprint 否
Null 您可以选择提供 Tableau Server 生成的指纹,也可以将 server.crt 文件复制到 Resource Monitoring Tool 服务器 (RMT Server) 计算机。如果您选择复制证书文件,则不必提供指纹。有关详细信息,请参见配置 Postgres SSL 以允许从客户端直接连接。 将引导程序文件下载到可从 Tableau Server 节点访问的位置。
rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>
可选步骤 - 仅在不使用 SSD 时:默认情况下,会针对 SSD 优化 Resource Monitoring Tool。如果未使用 SSD 硬件,请运行以下命令:
sudo /opt/tableau/tabrmt/master/tabrmt-master optimize --no-ssd
若要安装 RMT Server,请执行以下操作:
- 运行 RMT Server 安装程序
- 下载 RMT Server 安装程序,并将其保存到可以从计划安装 RMT Server 的计算机上访问的位置。
- 以管理员身份打开命令提示符。
导航到 RMT Server 安装程序的位置,并使用以下命令运行 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 Server。
- 配置 RMT Server。
运行以下命令并提供选项:
rmtadmin master-setup [options]
配置选项可以通过命令提示符(配置文件)提供。如果未提供选项,则会应用除管理员密码外的默认值。管理员用户名将设置为 admin,并将提示您提供密码。
示例命令,包括所需的 password 参数:
rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>
下表列出了用于配置 RMT Server 所需的选项和一些常用选项。有关配置选项的完整列表,请参见rmtadmin 命令行实用工具。
注意:需要 HTTPS 选项来确保 RMT Server 和用户之间的安全通信。当您需要 HTTPS 进行通信时,还必须为应该用于这些通信的证书选择一种模式。下表包括各种选项。若要详细了解这些模式和证书,请参见安装 Tableau Resource Monitoring Tool。
选项 是否必需? 默认 描述 admin-password 是
密码可以在命令行中提供,也可以提供包含要使用的密码的文件。如果未提供任何一项,系统将提示您输入密码。
不适用 管理员用户的密码。 admin-password-file 否
密码可以在命令行中提供,也可以提供包含要使用的密码的文件。如果未提供任何一项,系统将提示您输入密码。
不适用 存储管理员用户密码的文件。 admin-username 否 admin 管理员用户的用户名。 http-port 否 80 require-https 否 False 将 http 流量重定向到 HTTPS。 https-certificate-mode 否 默认
可用选项:
- 默认
- 存储
- 本地
要对 HTTPS 证书执行的证书搜索的类型。
默认:此模式使用安装程序提供的默认自签名证书。
存储:此模式允许您在 Windows 证书存储中输入证书的指纹。
本地:允许您在 <安装目录>\config 文件夹中指定基于文件的证书。默认情况下,此文件夹为 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config。
https-certificate-store-thumbprint 否 Null 在“存储”证书模式下要搜索的 HTTPS 证书哈希/指纹。 https-certificate-local-name 否 Null
注意:如果未指定,Resource Monitoring Tool 安装时将附带自签名证书,并将使用该证书进行 HTTPS 通信。
不带文件扩展名的 HTTPS 证书文件的名称。 https-certificate-local-password 否 Null 用于 HTTPS 证书的密码。 https-certificate-local-password-file 否 Null 包含用于 HTTPS 证书的密码的文件的路径。
创建环境
运行以下命令以创建环境:
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-username 否 Null 用于连接到 Tableau Server API 的帐户的用户名。用户帐户应该是可以访问所有 Tableau Server 站点的 Tableau Server 管理员。 --api-password 否
(如果您指定 Tableau API 用户名,您将提供密码,或指定文件路径和包含密码的文件)
Null
用于连接到 Tableau Server API 的 Tableau Server API 用户帐户的密码。
--api-password-file 否 Null 文件的路径和包含 Tableau Server API 用户帐户密码的文件的名称。 --repository-server 是 Null
这是与 Tableau Server 一起安装的 PostgreSQL 数据库的服务器名称 --repository-port 是 Null Tableau Server 存储库数据库的的端口号。 --repository-username 是 Null 用于连接到随 Tableau Server 存储库一起安装的 PostgreSQL 数据库的用户名。
出于性能原因,Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点,必须启用对存储库的访问,并为 readonly 数据库用户设置密码。有关详细信息,请参见启用对 Tableau Server 存储库的访问。
--repository-password 是 Null 用于连接到随 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户的密码。
出于性能原因,Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点,必须启用对存储库的访问,并为 readonly 数据库用户设置密码。有关详细信息,请参见启用对 Tableau Server 存储库的访问。
--repository-password-file 否 Null 包含用于连接到与 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户密码所在文件名的路径。 --repository-ssl-mode 否
首选 Tableau Server 存储库 SSL 模式:
选择“首选SSL”或“需要 SSL”以配置与 Tableau 存储库的 SSL 连接。
选择“禁用”以从不使用 SSL 建立 Tableau Server 存储库连接。
--repository-ssl-thumbprint 否
Null 您可以选择提供 Tableau Server 生成的指纹,也可以将 server.crt 文件复制到 Resource Monitoring Tool 服务器 (RMT Server) 计算机。如果您选择复制证书文件,则不必提供指纹。有关详细信息,请参见配置 Postgres SSL 以允许从客户端直接连接。 将引导程序文件下载到可从 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(包括数据目录),请使用 |
/passive | 运行安装程序并显示最少的 UI,并且不显示提示。 | |
/quiet | /silent | 以无人参与的完全无提示模式运行安装程序。不显示任何 Web 界面或提示。 | 使用 /quiet 或 /silent,而不是两者。 |
/norestart | 运行安装程序而不重新启动 Windows,即使必须重新启动也是如此。 | 在某些极少数情况下,即使使用此选项,也无法抑制重新启动。在跳过之前系统重新启动时,很有可能发生这种情况。举例来说,如果在安装其他软件期间跳过了重新启动。 |
/log <log-file> | 将信息记录到指定的文件和路径。默认情况下,系统使用命名约定 Tableau_Resource_Monitoring_Tool_<版本代码> 在 %TEMP% 中创建日志文件。 | 如果未指定文件位置,则将日志文件写入 TEMP 文件夹 - C:\Users\<用户名>\AppData\Local\Temp。安装之后,检查此日志文件来查找错误。 例如: |
属性:
属性 | 描述 | 注释 |
---|---|---|
InstallFolder=<path\to\installation\directory> | 安装到指定的非默认安装位置。 | 指定用于安装 RMT 的位置。如果未使用,则 RMT 将安装到 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master。 示例: |
ACCEPTEULA=1|0 | 接受最终用户许可协议 (EULA)。对于初始节点和附加节点上的无提示和被动安装为必需。1=True,接受 EULA,0=false,不接受 EULA。 | 如果使用 /passive、/silent 或 /quiet 时未包括此开关,则安装程序将无法以无提示形式运行。如果包含此属性但设置为 0,安装程序将失败 |
谁可以执行此操作
为了安装 Resource Monitoring Tool,您必须具有以下所有各项:
Windows
- 正在安装 Resource Monitoring Tool 的计算机上的管理员权限。
- Tableau Server 管理员站点角色。
- Resource Monitoring Tool 管理员帐户。
Linux
- 用于安装代理的用户帐户的完全 sudo 访问权限。
- Resource Monitoring Tool 管理员帐户