Atualização do RMT: referência técnica

Esta seção é um guia de referência técnica para os limites operacionais, caminhos do sistema e portas de rede verificados durante o processo de atualização. Use essas tabelas para diagnosticar rapidamente falhas de validação e alinhar seu ambiente com as linhas de base do RMT necessárias.

Observação: para nos alinhar com os valores de Igualdade de nossa empresa, atualizamos o RMT Master para o RMT Server. Em alguns casos, os caminhos e comandos de instalação do RMT Server podem usar o termo “master” em vez de “server”. Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte Sobre o Tableau help(O link abre em nova janela).

Verificações de integridade pré-atualização

A verificação de integridade pré-atualização inspeciona seu host do RMT Server ou Agent enquanto a instalação existente ainda está intacta, como serviços em execução, banco de dados acessível e gera um relatório detalhado PASS/FAIL/WARN. Ele executa mais de 80 verificações individuais em recursos do sistema, contas, permissões de arquivo, PostgreSQL, RabbitMQ, rede, arquivos de configuração e serviços RMT. A tabela a seguir lista as verificações realizadas antes da atualização. Se algum item retornar um status FAIL (Código de saída 2), a atualização será cancelada.

Sistema e hardware

ID de verificaçãoNome PlataformasCondição de falha (FAIL)/aviso (WARN)
Nº 1Sistema operacionalLinux, WindowsWARN A versão do sistema operacional não está na lista de permissões pré-verificação. A lista suportada é RHEL 8.x/9.x, Ubuntu 20.04/22.04/24.04, CentOS Stream 8/9, Oracle Linux 8.x/9.x, AlmaLinux 8.x/9.x, Rocky Linux 8.x/9.x, Amazon Linux 2023 e Windows Server 2019/2022
Nº 2Espaço em discoLinux, WindowsFAIL RMT Server < 20 GB ou Agent < 5 GB livres. WARN RMT Server < 50 GB ou Agent < 10 GB livres
Nº 2aTipo de discoLinux, WindowsINFO Informa se a unidade é SSD ou HDD
Nº 3

RAM

Linux, WindowsWARN RMT Server < 8 GB (mínimo) ou Agent < 4 GB (mínimo)
Nº 4Núcleos de CPULinux, WindowsWARN RMT Server < 8 GB (mínimo) ou Agent < 4 GB (mínimo)
Nº 4aInstruções de CPULinux, WindowsFAIL (Linux): sse4_2 ou popcnt ausentes. WARN (Windows): CPU mais antiga detectada.
#4bVC++ RedistWindowsFAIL Visual Studio 2022 C++ Redistributable ausente.
#4cOpenSSL DLLsWindowsINFO Verifica libcrypto-3-x64.dll e libssl-3-x64.dll
Nº 5Tempo de atividade do sistemaLinux, WindowsINFO: Nota se < 10 minutos (reboot bastante recente) ou > 90 dias (patches pendentes)
Nº 6Systemd em execuçãoLinuxFAIL systemd não está em execução, PASS: em execução ou degradado
Nº 7Modo FIPSLinux, WindowsFAIL (Windows): habilitado no registro, PASS FIPS desabilitado. WARN (Linux) Incompatibilidade com config.json. PASS Correspondência entre SO e configuração
Nº 7aVersão do PowerShellWindowsINFO Versão do PowerShell
#7bLocalidade do sistemaWindowsINFO Informações de localidade do sistema
#7cIntegridade do WMIWindowsWARN O repositório WMI é inconsistente

 

Contas e permissões

ID de verificaçãoNome PlataformaCondição de falha (FAIL)/aviso (WARN)
Nº 8Conta de serviçoLinux, WindowsFAIL Conta de serviço do RMT ou serviço do Windows não encontrado
Nº 9Associação ao grupoLinuxFAIL Grupos de serviço necessários (por exemplo, rmtmasterapp, rmtmasterconfig e assim por diante) ausentes
Nº 10Usuário SystemdLinuxFAIL O usuário systemd daemon/linger não está ativo
Nº 44pamtester instaladoLinuxWARN se não estiver instalado. Para corrigir isso, instale yum install pamtester ou apt install libpam-runtime

Propriedade de diretório e permissões para Linux

ID de verificaçãoDiretório Expected Owner:GroupModo esperado
Nº 11Config dirtabrmt-master:rmtmasterconfig2775
Nº 12Log dirtabrmt-master:rmtmasterlogs2775
Nº 13Data dir (+ PG/RMQ subdirs)Component-appropriate2775
Nº 14Prerequisites dirsroot ou usuário do componente755
Nº 14aArquivo rabbitmq-defaultsGroup-writable necessáriog+w
Nº 15SSL cert dirtabrmt-master:rmtopenssl2775
Nº 15aHome directoryUsuário do componente770
#15b/etc/profile.d/tabrmt-*.shrootpadrão
#15cConfig dir setgid bit--2xxx obrigatório
Nº 16environment.bashUsuário do componentegroup-writable

Gravidade: FAIL na propriedade apenas para o conjunto de diretório de dados (Nº 13 e Nº 15). Todas as outras verificações do diretório Linux (Nº 11, Nº 12, Nº 14, Nº 14a, Nº 15a–c, Nº 16) emitem WARN sobre incompatibilidades de propriedade/modo porque a pós-instalação do instalador reaplica a propriedade durante a atualização. WARN se o modo de permissão estiver incorreto, mas a propriedade estiver correta.

Propriedade de diretório e permissões para Windows

Verificação NomeGravidade
Nº 11Config dir ACLsFAIL se o usuário do serviço não tiver FullControl
Nº 12Log dir ACLsFAIL se o usuário de serviço não tiver Modify
Nº 13Data dir ACLs (RMT Server)FAIL se o usuário do serviço não tiver FullControl nos diretórios de dados PG/RMQ
Nº 14Prereqs dir ACLs (RMT Server)WARN se não tiver ReadAndExecute (aviso: cada atualização reinstala os MSIs prereq e suas ações pós-instalação reaplicam ACLs)
Nº 15SSL cert dir ACLs (RMT Server)FAIL se o usuário do serviço não tiver FullControl
Nº 16aIdentidade do usuário de serviçoPASS (informativo: mostra como usuário o serviço é executado)
#16bPrivilégio SeServiceLogonRightINFO se encontrado; WARN se não for encontrado ou se secedit falhar
#16cACLs do usuário de serviço em dirs do RMTFAIL se o usuário do serviço não tiver os direitos necessários

 

Banco de dados (PostgreSQL)

Todas as verificações de PostgreSQL executam apenas no RMT Server.

ID de verificaçãoNome Requer a opção --db-passwordCondição de falha (FAIL)/aviso (WARN)
Nº 17Serviço PGNãoFAIL Serviço local interrompido E desativado
Nº 18Porta 5555 escutandoNãoWARN (grupo de seguranço/VPC / RDS) Não está ouvindo
Nº 19DB ConnectionSimWARN Não é possível se conectar ao banco de dados interno (erro de SSL, senha ou rede)

 

Mensagens (RabbitMQ)

As verificações de mensagens (RabbitMQ) são executadas somente no RMT Server.

ID de verificaçãoNome Condição de falha (FAIL)/aviso (WARN)
Nº 22Serviço RMQFAIL Serviço local interrompido E desativado
Nº 24Fila de pendênciasWARN Qualquer fila que tenha > 10.000 mensagens
Nº 25Usuários do RabbitMQWARN se o usuário padrão guest ainda existir
Nº 26Conexões ativasINFO somente. Relata o número de conexões ativas
Nº 27Erlang cookie acessívelWARN se o arquivo de cookie estiver ausente, se as permissões estiverem erradas (deve ser o modo 400 ou 600)
Nº 27aConjunto ERLANG_HOMEWARN (Windows somente) se “ERLANG_HOME” não estiver definido ou se o caminho não existir.
#27bValidade de SSLFAIL Os certificados expiraram
#27cAlarme de discoFAIL < 10 GB livres na partição RMQ (A atualização travará)
Nº 45Diretório de certificados preenchidoWARN se cert dir existir, mas estiver vazio ou ausente arquivos de certificado esperados (server cert, key, CA cert)

Rede e configuração

ID de verificaçãoNome Condição de falha (FAIL)/aviso (WARN)
Nº 28a/bComunicações Agent-MasterWARN O Agent não pode entrar em contato com o Master em 5671, 5672, 80 ou 443
Nº 33-35JSON/Bash ConfigFAIL config.json, setup.json ou environment.bash ausentes ou inválidos
Nº 36aVersão conhecida e inválidaFAIL A versão atual é 2025.3.0 (Atualização de blocos de regressão)

Serviços e backup

ID de verificaçãoNome Condição de falha (FAIL)/aviso (WARN)
Nº 38Todos os serviços RMT em execuçãoWARN para cada serviço interrompido
Nº 38aProcessos encalhadosFAIL Processos tabrmt-* persistentes encontrados após a interrupção dos serviços
Nº 39Processador em execução em segundo planoWARN se o processo do host não estiver em execução
Nº 40Lembrete de backup antes da atualizaçãoWARN como lembrete para fazer backup da configuração antes de atualizar
Nº 41TopologiaINFO somente. Relata o tipo de nó Master/Agent e (com banco de dados) o número de agentes ativos
Nº 42Inventário de versão de componenteINFO somente. Relatórios sobre RMT, versões do PostgreSQL, RabbitMQ, OpenSSL
Nº 43Resumo das especificações da máquinaINFO somente. Relatórios sobre SO, núcleos de CPU, RAM, espaço livre em disco

 

Verificações de integridade pós-atualização

Essas verificações são executadas após a atualização. Eles não bloqueiam nada, e falhas não interrompem a atualização, mas indicam problemas pós-instalação.

ID de verificaçãoNome ComponenteCondição de falha (FAIL)/aviso (WARN)
Nº 1a-dServiços e processosRMT Server, AgentFAIL Os serviços Main, PG ou RMQ não estão em execução
Nº 2Supervisor do processo de hostRMT Server, AgentWARN Processo do supervisor de host ausente (sem recuperação automática)
Nº 3a-bIntegridade do arquivo de configuraçãoRMT Server, AgentFAIL se houver JSON ausente ou inválido
Nº 4a-bPermissões de arquivosRMT Server, AgentFAIL Config/Log dirs não legíveis/graváveis por conta de serviço
Nº 5a-dEscuta de portaRMT ServerFAIL Web (443), AMQP (5672) ou DB (5555) não escutam
Nº 6Conectividade PostgreSQLRMT ServerFAIL PostgreSQL não aceita conexões
Nº 7Status do RabbitMQServidor RMTSKIP se externo. FAIL após todas as novas tentativas esgotadas.
Nº 8aConsumidores da filaRMT ServerWARN Existe uma lista de pendências, mas não há consumidores ativos (trabalhadores Master, desconectados)
Nº 9Alarmes RMQRMT ServerFAIL Alarmes de memória ativa ou recursos de disco detectados
Nº 10Certificado SSL RabbitMQServidor RMTFAIL se o certificado expirou. WARN se os certificados expirarem dentro de 30 dias
Nº 11Correspondência FIPSRMT Server, AgentFAIL Incompatibilidades de estado FIPS do OS com configuração habilitada isFIPSEnabled
Nº 12Resposta HTTP do servidor da WebServidor RMTFaz o GET HTTP para “https://localhost:<port>/authentication/login”. PASS em 200 ou 302. FAIL se conexão recusada/estourar tempo limite. WARN sobre outros erros.
Nº 13Validade do certificado HTTPSRMT ServerFAIL O certificado TLS do servidor da Web expirou
Nº 14a-dEspaço em discoRMT Server, AgentFAIL < 1 GB free. WARN: < 5 GB free
Nº 15Erros de log recentesRMT Server, AgentFAIL Erros FATAL nos logs. WARN: ERROS CRÍTICOS
Nº 16Status do RMTRMT Server, AgentFAIL rmtadmin status retorna padrões de falha
Nº 17Histórico de log do AgentAgentVerifica os arquivos de rastreamento de log (.history, .json) no diretório de dados do agente. WARN se os arquivos estiverem ilegíveis ou corrompidos
Nº 18a-fVersão do inventárioRMT Server, AgentINFO sobre versão do RMT, versão do PostgreSQL, versão do RabbitMQ, versão do Erlang/OTP, .NET Runtime (Windows)/OS (Linux), versão do OS (Windows)/Kernel (Linux)

Códigos de saída da verificação de integridade

Use os códigos de saída a seguir para interpretar os resultados dos scripts de verificação de integridade pré e pós-atualização.

Scripts pré-atualização

Código de saídaStatus Comportamento da atualização
0READY TO UPGRADEAtualização continua
1UPGRADE WITH CAUTIONAtualização continua; revisar avisos
2Do not upgradeAtualização cancelada
3Script ErrorVerificar o ambiente de execução

Scripts pós-atualização

Código de saídaStatus
0ALL PASSED
1WARNINGS PRESENT
2CRITICAL FAILURES

Alterações de gravidade do InstallerContext

Quando executadas com -InstallerContext durante atualizações MSI de Windows automáticas, as verificações a seguir se comportam de maneira diferente do padrão manual. O comportamento padrão (sem InstallerContext) *já* é WARN para os estados “stopped but not Disabled” / “port not listening”; FAIL está reservado para “Stopped+Disabled”. Em “-InstallerContext”, até mesmo a ramificação “Desativada” é relatada como WARN para que uma atualização em andamento orientada pelo instalador nunca seja vetada por um estado transitório que o instalador está prestes a corrigir.

Verificação Nome PadrãoInstallerContext
Nº 17Serviço PGWARN se parado, FAIL se parado e desativado, INFO se tudo parouWARN
Nº 18Porta PGWARN se não estiver ouvindo, INFO se todos os serviços estiverem paradosWARN
Nº 22Serviço RabbitMQWARN se Stopped, FAIL se Stopped+Disabled, INFO se tudo parouWARN
Nº 23Port 5672 (AMQP)WARN se não estiver ouvindo, INFO se todos os serviços estiverem paradosWARN
Nº 38aProcessos do RMT encalhados(ver descrição da verificação)SKIP (instalador gerencia o ciclo de vida do processo)

Limites pré-atualização

Limite RMT Server AgentUnidade
Espaço em disco FAIL205GB livres
Espaço em disco WARN5010GB livres
Temp dir FAIL55GB livres
Temp dir WARN1010GB livres
FALHA NA RAM84GB
RAM WARN168GB
CPU FAIL42núcleos
CPU WARN84núcleos
Tamanho do banco de dados FAIL500-GB
Tamanho do banco de dados WARN200-GB
Esquema Hangfire FAIL10-GB
Esquema Hangfire WARN1-GB
WAL dir FAIL (Windows)10-GB
WAL dir FAIL (Windows)2-GB
WAL dir FAIL (Linux)10-GB
Mnesia dir WARN5-GB
Alarme de disco RabbitMQ FAIL10-GB livres
Fila de pendências WARN10.000-mensagens
Expiração do certificado WARN3030dias
Retenção de limpeza WARN180-dias
Proporção de tupla morta WARN20-por cento
Batimento cardíaco obsoleto do Agent15-minutos
Idade do driver de rede WARN3-anos
Log dir size WARN55GB
Log dir size WARN (grave)2020GB

Limites pós-atualização

LimiteValor Unidade
Espaço em disco FAIL1GB livres
Espaço em disco WARN5GB livres
Expiração do certificado WARN30dias
Fila de pendências WARN10.000mensagens
Janela de varredura de log60minutos
Tentar novamente a inicialização do RabbitMQ6 tentativas x 5 seg30 segundos no total

 

Versões mínimas de componentes suportadas

ComponenteVersão mínima
RabbitMQ>= 3.10.10
Versão do Agent>= 2023.1.0

Automação e integração de CI/CD

No 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
```

No Windows:

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

 

Referência sobre diretório de instalação

Para invocar manualmente os utilitários de diagnóstico subjacentes ou verificar sua estrutura de instalação, consulte os caminhos de diretório específicos da plataforma:

Estrutura de diretórios do Linux

```

/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

```

Estrutura de diretórios do Windows

```

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

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

```

Portas de rede necessárias

PortaServiço Direção
80Interface do usuário da Web do RMT (HTTP)Entrada
443Interface do usuário da Web do RMT (HTTPS)Entrada
5672RabbitMQ AMQPEntrada no RMT Server
5671RabbitMQ AMQP sobre TLSEntrada no RMT Server
15672Interface do usuário de gerenciamento do RabbitMQLocal
25672Nó interno do RabbitMQLocal
5555PostgreSQL internoLocal
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!