Upgrading Resource Monitoring Tool

Applies to: Tableau Advanced Management

These instructions are for upgrading an existing installation of Tableau Resource Monitoring Tool.

In an effort to align with our company values of Equality, we have changed non-inclusive terminology where possible. Because changing terms in certain places can causing a breaking change, we maintain the existing terminology. So, you may continue to see the terms in CLI commands and options, installation folders, configuration files. and other instances. For more information, see About Tableau Help(Link opens in a new window).

Note: The Resource Monitoring Tool performs an in-place upgrade, upgrading your current installation to the newer version. Do not uninstall your existing installation before upgrading.

Upgrade Notes

Consider the following before you start the upgrade process:

  1. If you are planning to move to use an external repository (PostgreSQL) or external message queue service (RabbitMQ), make sure you review the upgrade best practices section in the following topics:

  2. Starting in version 2022.3, Tableau Resource Monitoring Tool has built-in encrypted communications between RMT Server and Agents. However, you will need to run rmtadmin rotate-mq-certificates on all the Agents to enable TLS. This applies to RabbitMQ that is configured locally on the same machine as RMT Server. For more details on how to do this, see Upgrade steps with enabling TLS for RabbitMQ below.

  3. You may need to reboot the machine during an upgrade. This usually occurs if files are locked and cannot be updated by the installer. If necessary, you will be prompted by the installer. Because of this possibility, you may want to consider doing your upgrades during non-work hours.

  4. Sometimes, the Resource Monitoring Tool will modify the database and in such cases, the upgrade process will include a database migration. In case of a database migration, you will see a message banner at the top of the RMT Server web page with a time estimate for completing the process. An example screen shot is shown below:

    On expanding the banner you can review the details of the impact of the upgrade. Changes are unique to each release and the details shown are specific to the release.

  5. The Resource Monitoring Tool is backward compatible with Tableau Server versions, but not forward compatible. This means the Resource Monitoring Tool version should be equal to or greater than the Tableau Server version you are monitoring.

    For compatibility reasons, Tableau recommends you upgrade the Resource Monitoring Tool first and then follow with a Tableau Server upgrade. For more information, see Product Compatibility with Tableau Server.

How to Upgrade the Resource Monitoring Tool

We recommend you do an in-place upgrade of Resource Monitoring Tool. If you uninstall Resource Monitoring Tool and install a new version of the database, it may result in data corruption and you will be prompted to reinstall the previous version and re-do the upgrade process.

  1. Log in to the Resource Monitoring Tool in a browser and confirm it is working before starting the upgrade.

  2. Copy the new version of the RMT Server package to the RMT Server machine.

  3. Copy the new version of the RMT Agent package to the machines where you have RMT Agents installed. RMT Agents are installed on Tableau Server nodes you are monitoring.

  4. On each Tableau Server node running the RMT Agent service, switch to the tabrmt-agent user and stop the RMT Agent service:

    sudo su --login tabrmt-agent
rmtadmin stop
exit

  5. Switch to the tabrmt-master user on the RMT Server and stop the RMT Server service using the following command:

    sudo su --login tabrmt-master
rmtadmin stop
exit

  6. Wait until there are not any running processes with tabrmt in the name before continuing to the next step.

    Once the services have been stopped, it is best practice to check for any Resource Monitoring Tool processes that are running after the services have been stopped: Any with tabrmt-agent or tabrmt-master. This does not include PostgreSQL or RabbitMQ. You can check the status using the following command:

    rmtadmin status

  7. Run the upgrade commands on the RMT Server. This will upgrade the existing version to the new version:

    For RHEL-like distributions including CentOS:

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

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

    For Ubuntu distributions:

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

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

  8. Once the RMT Server has been upgraded, upgrade all the RMT Agents by running the following command:

    For RHEL-like distributions including CentOS:

    sudo yum install <pathtoagentinstaller>/<tabrmt-agent-setup-<version>-x86_64.rpm>

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

    For Ubuntu distributions:

    sudo apt install <pathtoagentinstaller>/<tabrmt-agent-setup-<version>-amd_64.deb>

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

  9. Confirm the RMT Server and Agents are running. Start the RMT Server and Agents if they do not automatically restart after the upgrade is complete.

  10. To verify RMT Agents have been upgraded, log in to Resource Monitoring Tool in a browser and go to the Admin menu, select Environments, and click the Edit Environment icon to see the environment details. In the Servers tab, you can see the version of the RMT Agent. This can be useful to determine which RMT Agents have been upgraded when you have a multi-node Tableau Server cluster.

Upgrade steps with enabling TLS for RabbitMQ

Since the agents in versions earlier than 2022.3 have been communicating using unencrypted connection to the RabbitMQ message queue service, when upgrading to version 2022.3 or later, those agents need to be updated to use the new secure connection details. The steps to do this are as follows:

  1. After completing the upgrade steps described in the above section, stop all agents by running the following command:

    rmtadmin stop --agent

  2. Download the bootstrap file for the environment by running the following command:

    rmtadmin bootstrap-file --env<myenvironment> --filename <The absolute or relative path including the file name>

  3. Run the following command on each of the machines where the Agent is installed:

    rmtadmin rotate-mq-certificate <BOOTSTRAP_FILE> --username=<RMT Server Username> --password-file=<RMT Server Password file name>

  4. Restart each Agent machine after successfully running the rmtadmin rotate-mq-certificate command.

Who can do this

To upgrade Resource Monitoring Tool, you will need to have the following permissions:

  • User account with full sudo access.
  • Tableau Server Administrator.
  • Resource Monitoring Tool Administrator.
Back to top
Thanks for your feedback!Your feedback has been successfully submitted. Thank you!