Tableau Server on Windows Help

This section is a technical reference guide for the operational thresholds, system paths and network ports checked during the upgrade process. Use these tables to quickly diagnose validation failures and align your environment with required RMT baselines.

Note: To align with our company values of Equality, we have updated RMT Master to RMT Server. In some cases, RMT Server installation paths and commands may use the term ‘master’ instead of ‘server’. So, you may continue to see the term 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)..

Pre-upgrade health checks

The pre-upgrade health check inspects your RMT Server or Agent host while the existing installation is still intact like services running, database accessible and generates a detailed PASS / FAIL / WARN report. It runs over 80 individual checks across system resources, accounts, file permissions, PostgreSQL, RabbitMQ, networking, configuration files and RMT services. The following table lists the checks performed before the upgrade. If any item returns a FAIL status (Exit Code 2), the upgrade is cancelled.

System and hardware

Accounts and permissions

Directory ownership and permissions for Linux

Severity: FAIL on ownership only for the data-dir set (#13 and #15). All other Linux directory checks (#11, #12, #14, #14a, #15a–c, #16) emit WARN on ownership/mode mismatches because the installer’s post install re-applies ownership during upgrade. WARN if permission mode is wrong but ownership is correct.

Directory ownership and permissions for Windows

Database (PostgreSQL)

All PostgreSQL checks run only on the RMT Server.

Messaging (RabbitMQ)

The Messaging (RabbitMQ) checks run only on the RMT Server.

Network and configuration

Services and backup

Post-upgrade health checks

These checks run after the upgrade. They are non-blocking and failures do not stop the upgrade but indicate post-install issues.

Health check exit codes

Use the following exit codes to interpret the results of both the pre-upgrade and post-upgrade health check scripts.

Pre-upgrade scripts

Post-upgrade scripts

InstallerContext severity changes

When run with -InstallerContext during automatic Windows MSI upgrades, the following checks behave differently from the manual default. The default (non-InstallerContext) behaviour is *already* WARN for ‘stopped but not Disabled’ / ‘port not listening’ states; FAIL is reserved for ‘Stopped+Disabled’. Under `-InstallerContext`, even the ‘Disabled’ branch is reported as WARN so an in-flight installer-driven upgrade is never vetoed by a transient state the installer is about to fix.

Pre-upgrade thresholds

Post-upgrade thresholds

Minimum supported component versions

Automation and CI/CD Integration

For Linux:

```base
# Linux
sudo bash rmt-pre-upgrade-check.sh --component master --db-password "$DB_PASSWORD"
EXIT_CODE=$?
if [ $EXIT_CODE -eq 2 ]; then
echo "BLOCKED: Fix critical issues before upgrading"
exit 1
fi
```

For Windows:

```powershell
# Windows
.\rmt-pre-upgrade-check.ps1 -Component master
if ($LASTEXITCODE -eq 2) {
Write-Error "BLOCKED: Fix critical issues before upgrading"
exit 1
}
```

Installation directory reference

To manually invoke the underlying diagnostic utilities or verify your installation structure, refer to the platform-specific directory paths:

Linux directory structure

```

/opt/tableau/tabrmt/ # Install root

+-- master/ # Master application binaries

+-- agent/ # Agent application binaries

+-- prerequisites/ # Bundled dependencies

/var/opt/tableau/tabrmt/ # Data root

+-- master/config/ # config.json, setup.json

+-- master/logs/ # Application logs

+-- data/postgresql15/ # PostgreSQL data files

+-- data/rabbitmq313/ # RabbitMQ data/mnesia

+-- data/ssl/ # TLS certificates

/etc/opt/tableau/tabrmt/

+-- master/environment.bash # Master environment variables

+-- agent/environment.bash # Agent environment variables

```

Windows directory structure

```

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\ # Install root

C:\ProgramData\Tableau\Tableau Resource Monitoring Tool\ # Data root

```

Required network ports