Scripts de verificação de integridade de atualização do RMT
A partir da versão 2025.3.6, o instalador do RMT inclui um script de verificação de integridade pré-atualização e pós-atualização para validar seu ambiente de Resource Monitoring Tool (RMT) do Tableau antes e depois da atualização. Esses scripts identificam problemas pré-existentes em seu ambiente, como configuração incorreta, desvio de permissão, escassez de espaço em disco, certificados expirados ou falhas de serviço que estavam presentes antes e podem causar qualquer falha de atualização.
Os scripts de verificação de integridade pré e pós-atualização podem identificar os seguintes problemas:
Preparação de banco de dados e disco: detecta se um banco de dados grande ou arquivos WAL excessivos farão com que a migração trave ou esgote o espaço em disco.
Integridade de permissão e segurança: identifica a propriedade de arquivo alterada ou certificados de SSL expirados que, de outra forma, impediriam a reinicialização dos serviços ou a reconexão dos agentes.
Validação de dependência: garante que os componentes Windows necessários, como o Visual C++ 2022 Redistribuível e o OpenSSL 3.x, estejam presentes antes da instalação do PostgreSQL 15.
Segurança de lógica de versão: evita erros de “falso downgrade” causados por regressões de metadados de versão.
Script pré-atualização
O script pré-atualização é executado automaticamente ao iniciar uma atualização. Ele inspeciona seu host RMT Server ou Agent enquanto a instalação existente ainda está intacta e gera um relatório PASS/FAIL/WARN.
No Linux, a verificação pré-atualização é executada automaticamente como parte de:
sudo bash upgrade-rmt-master ...
sudo bash upgrade-rmt-agent ...
Para ignorar a verificação automática (não recomendado):
sudo bash upgrade-rmt-master --skip-pre-upgrade-check ...
No Windows, o instalador executa a verificação de pré-atualização automaticamente. Durante a instalação, também será solicitado se você deve ou não ignorar a atualização. No entanto, isso não é recomendado.
Verificação manual pré-atualização
Você pode executar o script manualmente para visualizar quaisquer problemas em potencial. Para executá-lo manualmente, use as seguintes etapas com base no seu sistema operacional:
No Linux:
Execute os comandos como usuário root. Para incluir verificações de banco de dados, use o comando export para passar sua senha com segurança.
sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh
Para executar com as verificações de PostgreSQL habilitadas, use o seguinte comando:
export RMT_DB_PASSWORD="<tabrmtdb-password>"
sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh
Para executar com um componente específico e caminho de saída, use o seguinte comando:
sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt
No Windows:
Os arquivos de pré-atualização do RMT Server são instalados por padrão no seguinte local:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1
Os arquivos pré-atualização do Agent são instalados por padrão no seguinte local:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1
Para executar o script manualmente, inicie o PowerShell como administrador e execute:
cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"
.\rmt-pre-upgrade-check.ps1
Para executar com as verificações de PostgreSQL habilitadas, use o seguinte comando:
$env:RMT_DB_PASSWORD = "<tabrmtdb-password>"
.\rmt-pre-upgrade-check.ps1
Para executar com um componente específico e caminho de saída, use o seguinte comando:
.\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\temp\rmt-report.txt
Opções adicionais
Use as seguintes opções para personalizar a verificação pré-atualização:
-Component
Especifique RMT Server ou Agent. O script detecta isso automaticamente a escolha for omitida
--db-password / -DbPassword
A senha de administrador do banco de dados RMT interno. Obrigatório para verificações de PostgreSQL.
--output / -OutputPath
Especifique onde salvar o relatório. Por padrão, fica salvo em /tmp/ (Linux) or C:\temp\ (Windows).
--target-version / -TargetVersion
A versão do RMT que você planeja instalar; habilita verificações específicas da versão.
--quiet / -Quiet
Filtra a saída para mostrar apenas os resultados FAIL e WARN.
--verbose / -Verbose
A saída exibe dados técnicos detalhados para cada verificação realizada.
Resultados do script e ações necessárias
A tabela a seguir explica o resultado do script e a ação necessária:
| Resultado | Status | Ação |
| PASS | CÓDIGO DE SAÍDA 0 | Nnhum problema encontrado. A atualização continua. |
| WARN | CÓDIGO DE SAÍDA 1 | A atualização continua, mas você deve revisar o relatório em busca de riscos não críticos. |
| FAIL | CÓDIGO DE SAÍDA 2 | Atualização cancelada. Você deve resolver esses problemas antes de executar novamente a atualização. |
Script pós-atualização
Os scripts de verificação de integridade pós-atualização são executados automaticamente no final de cada instalação e atualização do RMT. Ele verifica se todos os serviços foram iniciados corretamente, se a infraestrutura está íntegra e se a configuração está intacta. A verificação pós-atualização não bloqueia o instalador. Todas as falhas identificadas são registradas no relatório final.
Verificação manual pós-atualização
Para executá-lo manualmente, use as seguintes etapas com base no seu sistema operacional:
No Linux:
Execute os seguintes comandos como usuário root ou com privilégios sudo:
No RMT Server:
sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade
No Agent:
sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade
No Windows:
Os arquivos pós-atualização do RMT Server são instalados por padrão no seguinte local:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1
Os arquivos pós-atualização do Agent são instalados por padrão no seguinte local:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1
Para executar os scripts manualmente, abra o PowerShell como administrador e navegue até o diretório de instalação do RMT antes de executar os comandos:
No RMT Server:
.\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade
No Agent:
.\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade
Opções adicionais
Você pode usar as seguintes opções para personalizar o script:
--component / -Component
Especifique RMT Server ou Agent. O script tentará detectar isso automaticamente, se omitido.
--db-password / -DbPassword
A senha do administrador interno do banco de dados RMT. Isso é necessário para habilitar as verificações de PostgreSQL.
--output / -OutputPath
O caminho onde o arquivo de relatório será salvo. O padrão é /tmp/ (Linux) ou C:\temp\ (Windows).
--target-version / -TargetVersion
A versão do RMT específica para a qual você está atualizando, usada para verificações específicas da versão.
--quiet / -Quiet
Reduz a saída para mostrar apenas os resultados FAIL e WARN.
--verbose / -VerboseOutput
Fornece resultados técnicos detalhados para cada verificação realizada.
Observação: recomendamos definir RMT_DB_PASSWORD como uma variável de ambiente em vez de passá-la na linha de comando, pois os argumentos da linha de comando são visíveis na lista de processos.
Resultados do script e ações necessárias
A tabela a seguir explica o resultado do script e a ação necessária:
| Resultado | Status | Ação |
| PASS | CÓDIGO DE SAÍDA 0 | O sistema está íntegro. Não é preciso realizar ações. |
| WARN | CÓDIGO DE SAÍDA 1 | Revise os avisos; a maioria se resolve por conta própria (por exemplo, atraso temporário de inicialização do RabbitMQ). |
| FAIL | CÓDIGO DE SAÍDA 2 | Uma ou mais verificações críticas falharam; investigue e corrija. |
Relatórios
Você pode encontrar os relatórios pré-atualização aqui:
Linux:
/tmp/rmt-precheck-<timestamp>.txtWindows (Manual):
C:\temp\rmt-precheck-<component>-<timestamp>.txt
Você pode encontrar os relatórios pós-atualização aqui:
Linux:
<log-dir>/rmt-postcheck-report.txtWindows (Manual):
C:\temp\rmt-postcheck-<component>-<timestamp>.txtWindows (via instalador): quando o instalador executa a verificação, ele usa nomes de arquivo fixos:
C:\temp\rmt-postcheck-master-report.txtC:\temp\rmt-postcheck-agent-report.txt
Para obter informações sobre verificações pré e pós-atualização no relatório, consulte a seção Referência de atualização.
Exemplo de relatório
Veja a seguir um exemplo de relatório de verificação de integridade pré-atualização:
==================================================================
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