Ayuda de Tableau Server en Windows

A partir de la versión 2025.3.6, el instalador de RMT incluye un script de comprobación de estado anterior y posterior a la actualización para validar su entorno de Tableau Resource Monitoring Tool (RMT) antes y después de la actualización. Estos scripts identifican problemas preexistentes en su entorno, como errores de configuración, desviaciones de permisos, escasez de espacio en disco, certificados caducados o errores de servicio que estaban presentes antes y que pueden causar cualquier error de actualización.

Los scripts de comprobación de estado previos y posteriores a la actualización pueden identificar los siguientes problemas:

• Preparación de la base de datos y el disco: detecta si una base de datos de gran tamaño o un exceso de archivos WAL harán que la migración se bloquee o agote el espacio en disco.

• Integridad de permisos y seguridad: identifica la propiedad de archivos desplazada o los certificados SSL caducados que, de otro modo, bloquearían el reinicio de los servicios o la reconexión de los agentes.

• Validación de dependencias: garantiza que los componentes de Windows necesarios, como Visual C++ 2022 Redistributable y OpenSSL 3.x, estén presentes antes de instalar PostgreSQL 15.

• Seguridad de la lógica de versiones: evita los errores de “falsa degradación” causados por regresiones de metadatos de versión.

Script preactualización

El script previo a la actualización se ejecuta automáticamente al iniciar una actualización. Inspecciona su servidor de RMT o host de agente mientras la instalación existente aún está intacta y genera un informe PASS / FAIL / WARN.

En Linux, la comprobación previa a la actualización se ejecuta automáticamente como parte de lo siguiente:

sudo bash upgrade-rmt-master ...

sudo bash upgrade-rmt-agent ...

Para omitir la comprobación automática (no recomendado):

sudo bash upgrade-rmt-master --skip-pre-upgrade-check ...

En Windows, el instalador ejecuta automáticamente la comprobación previa a la actualización. Durante la instalación, también se le pedirá la opción de omitir la actualización. Sin embargo, no se recomienda.

Comprobación manual previa a la actualización

Puede ejecutar el script manualmente para obtener una vista previa de los posibles problemas. Para ejecutarla manualmente, siga estos pasos según su sistema operativo:

Para Linux:

Ejecute los comandos como usuario raíz. Para incluir comprobaciones de la base de datos, use el comando export para pasar la contraseña de forma segura.

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh

Para ejecutar con las comprobaciones de PostgreSQL habilitadas, use el siguiente comando:

export RMT_DB_PASSWORD="<tabrmtdb-password>"

sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh

Para ejecutar con un componente y una ruta de salida específicos, utilice el siguiente comando:

sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt

Para Windows:

Los archivos previos a la actualización para RMT Server se instalan de forma predeterminada en la siguiente ubicación:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1

Los archivos previos a la actualización del agente se instalan de forma predeterminada en la siguiente ubicación:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1

Para ejecutar el script manualmente, inicie PowerShell como administrador y ejecute:

cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"

.\rmt-pre-upgrade-check.ps1

Para ejecutar con las comprobaciones de PostgreSQL habilitadas, use el siguiente comando:

$env:RMT_DB_PASSWORD = "<tabrmtdb-password>"

.\rmt-pre-upgrade-check.ps1

Para ejecutar con un componente y una ruta de salida específicos, utilice el siguiente comando:

.\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\temp\rmt-report.txt

Opciones adicionales

Utilice las siguientes opciones para personalizar la comprobación previa a la actualización:

-Component

Especifique el servidor de RMT o el agente. El script lo detecta automáticamente si se omite

--db-password / -DbPassword

La contraseña de administrador de la base de datos interna de RMT. Necesario para comprobaciones de PostgreSQL.

--output / -OutputPath

Especifique dónde desea guardar el informe. De forma predeterminada, se guarda en /tmp/ (Linux) or C:\temp\ (Windows).

--target-version / -TargetVersion

La versión de RMT que planea instalar. Habilita las comprobaciones específicas de la versión.

--quiet / -Quiet

Filtra la salida para mostrar solo los resultados FAIL y WARN.

--verbose / -Verbose

La salida muestra datos técnicos detallados para cada verificación realizada.

Resultados del script y acciones requeridas

En la tabla siguiente se explica el resultado del script y la acción:

Script postactualización

Los scripts de comprobación de estado posteriores a la actualización se ejecutan automáticamente al final de cada instalación y actualización de RMT. Comprueba que todos los servicios se hayan iniciado correctamente, que la infraestructura esté en buen estado y que la configuración esté intacta. La comprobación posterior a la actualización no bloquea el instalador. Todos los errores identificados se registran en el informe final.

Comprobación manual posterior a la actualización

Para ejecutarla manualmente, siga estos pasos según su sistema operativo:

Para Linux:

Ejecute los comandos siguientes como usuario root o con privilegios sudo:

• Para el servidor RMT:

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade

• Para el agente:

sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade

Para Windows:

Los archivos de actualización posterior para RMT Server se instalan de forma predeterminada en la siguiente ubicación:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1

Los archivos de actualización posterior al agente se instalan de forma predeterminada en la siguiente ubicación:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1

Para ejecutar los scripts manualmente, abra PowerShell como administrador y vaya al directorio de instalación de RMT antes de ejecutar los comandos:

• Para el servidor de RMT:

.\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade

• Para el agente:

.\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade

Opciones adicionales

Puede utilizar las siguientes opciones para personalizar el script:

--component / -Component

Especifique el servidor de RMT o el agente. El script intentará detectarlo automáticamente, si se omite.

--db-password / -DbPassword

La contraseña para el administrador interno de la base de datos de RMT. Esto es necesario para habilitar las comprobaciones de PostgreSQL.

--output / -OutputPath

La ruta donde se guardará el archivo de informe. El valor predeterminado es /tmp/ (Linux) o C:\temp\ (Windows).

--target-version / -TargetVersion

La versión específica de RMT a la que está actualizando; se utiliza para las comprobaciones específicas de la versión.

--quiet / -Quiet

Reduce la salida para mostrar solo los resultados FAIL y WARN.

--verbose / -VerboseOutput

Proporciona resultados técnicos detallados para cada comprobación realizada.

Nota: Recomendamos configurar RMT_DB_PASSWORD como una variable de entorno en lugar de pasarla en la línea de comandos, ya que los argumentos de la línea de comandos son visibles en la lista de procesos.

Resultados del script y acciones requeridas

En la tabla siguiente se explica el resultado del script y la acción:

Informes

Puede encontrar los informes previos a la actualización aquí:

• Linux: /tmp/rmt-precheck-<timestamp>.txt

• Windows (Manual): C:\temp\rmt-precheck-<component>-<timestamp>.txt

Puede encontrar los informes posteriores a la actualización aquí:

• Linux: <log-dir>/rmt-postcheck-report.txt

• Windows (Manual): C:\temp\rmt-postcheck-<component>-<timestamp>.txt

• Windows (mediante el instalador): cuando el instalador ejecuta la comprobación, utiliza nombres de archivo fijos:

  • C:\temp\rmt-postcheck-master-report.txt

  • C:\temp\rmt-postcheck-agent-report.txt

  Para obtener información sobre las comprobaciones previas y posteriores a la actualización del informe, consulte la sección Referencia de actualización.

Ejemplo de informe

A continuación se muestra un ejemplo de informe de comprobación de estado previa a la actualización:

==================================================================
RMT Pre-Upgrade Health Check Report
Script Version : 1.0.0
Generated      : 2026-04-08 14:30:00
Component      : master
Hostname       : rmt-master-01.example.com
RMT Version    : 2025.1.9
==================================================================
OVERALL STATUS : UPGRADE WITH CAUTION (2 warning(s) -- review before proceeding)
PASS: 44  FAIL: 0  WARN: 2  INFO: 10  SKIP: 3
==================================================================
WARNINGS -- Review Before Upgrading
==================================================================
[WARN] #21d     Hangfire schema is 1.2 GB
Check 21g for delete_hash() volatility bug
[WARN] #24      1 queue(s) with >10000 messages (max: 15234)
Resolve backlogs before upgrading