--- schema_version: "1" id: f17c13c7a5d330dc01579a068351e90bac55d2995a0378b08200216bd865367c title: Scripts de verificação de integridade de atualização do RMT collection: tableau version: next locale: pt-br portal_url: https://docs.salesforce.com/tableau/next/pt-br/server/rmt-admin-upgrade-health-scripts.md canonical_url: https://help.tableau.com/v0.0/server/pt-br/rmt-admin-upgrade-health-scripts.htm source_site: help.tableau.com content_type: documentation content_hash: b7f2e9c77f76638e788e784e08403ce72d75e428d5b06f5f4ccb65ac1d257a61 description: Use the RMT pre-upgrade and post-upgrade health check scripts. --- [Pular para o conteúdo principal](#main-content) # 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="" 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 = "" .\\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:
ResultadoStatusAção
PASSCÓDIGO DE SAÍDA 0Nnhum problema encontrado. A atualização continua.
WARNCÓDIGO DE SAÍDA 1A atualização continua, mas você deve revisar o relatório em busca de riscos não críticos.
FAILCÓDIGO DE SAÍDA 2Atualizaçã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:
ResultadoStatusAção
PASSCÓDIGO DE SAÍDA 0O sistema está íntegro. Não é preciso realizar ações.
WARNCÓDIGO DE SAÍDA 1Revise os avisos; a maioria se resolve por conta própria (por exemplo, atraso temporário de inicialização do RabbitMQ).
FAILCÓDIGO DE SAÍDA 2Uma 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-.txt` - Windows (Manual): `C:\temp\rmt-precheck--.txt` Você pode encontrar os relatórios pós-atualização aqui: - Linux: `/rmt-postcheck-report.txt` - Windows (Manual): `C:\temp\rmt-postcheck--.txt` - Windows (via instalador): quando o instalador executa a verificação, ele usa nomes de arquivo fixos: - `C:\temp\rmt-postcheck-master-report.txt` - `C:\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](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-upgrade-reference.htm). ### 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