Hälsokontrollskript för RMT-uppgradering
Från och med version 2025.3.6 innehåller RMT-installationsprogrammet ett hälsokontrollskript före uppgradering och ett efter uppgradering för att validera Tableau Resource Monitoring Tool-miljön (RMT) före och efter uppgradering. De här skripten identifierar redan existerande problem i miljön – som felkonfiguration, behörighetsavvikelser, diskutrymmesbrist, utgångna certifikat eller tjänstfel som fanns tidigare och kan orsaka uppgraderingsfel.
Hälsokontrollskripten före och efter uppgradering kan identifiera följande problem:
Databas- och diskberedskap: Detekterar om en stor databas eller för många WAL-filer kommer att leda till att migreringen låser sig eller tar upp allt diskutrymme.
Behörighet och säkerhetsintegritet: Identifierar förskjutet filägarskap eller utgångna SSL-certifikat som annars skulle blockera tjänster från att starta om eller agenter från att återansluta.
Beroendevalidering: Säkerställer att nödvändiga Windows-komponenter, som Visual C++ 2022 Redistributable och OpenSSL 3.x, finns innan PostgreSQL 15 installeras.
Säkerhet för versionslogik: Förhindrar fel orsakade av ”falsk nedgradering” som orsakas av regressioner av versionsmetadata.
Skript före uppgradering
Skriptet före uppgradering körs automatiskt när du startar en uppgradering. Det inspekterar RMT Server- eller Agent-värden medan den befintliga installationen fortfarande är intakt och genererar en PASS/FAIL/WARN-rapport.
För Linux körs kontrollen före uppgradering automatiskt som en del av följande:
sudo bash upgrade-rmt-master ...
sudo bash upgrade-rmt-agent ...
Så här hoppar du över den automatiska kontrollen (rekommenderas inte):
sudo bash upgrade-rmt-master --skip-pre-upgrade-check ...
I Windows körs kontrollen före uppgradering automatiskt. Under installationen får du även möjlighet att hoppa över uppgraderingen. Det rekommenderas dock inte.
Manuell kontroll före uppgradering
Du kan köra skriptet manuellt för att förhandsgranska eventuella problem. Använd följande steg för att köra skriptet manuellt, baserat på ditt operativsystem:
För Linux:
Kör kommandona som en rotanvändare. Om du vill inkludera databaskontroller använder du exportkommandot för att skicka ditt lösenord på ett säkert sätt.
sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh
Om du vill köra med PostgreSQL-kontroller aktiverade använder du följande kommando:
export RMT_DB_PASSWORD="<tabrmtdb-password>"
sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh
Om du vill köra med en specifik komponent och utdatasökväg använder du följande kommando:
sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt
För Windows:
Kontrollfilerna för RMT Server installeras som standard på följande plats:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1
Kontrollfilerna för Agent installeras som standard på följande plats:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1
Om du vill köra skriptet manuellt startar du PowerShell som administratör och kör:
cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"
.\rmt-pre-upgrade-check.ps1
Om du vill köra med PostgreSQL-kontroller aktiverade använder du följande kommando:
$env:RMT_DB_PASSWORD = "<tabrmtdb-password>"
.\rmt-pre-upgrade-check.ps1
Om du vill köra med en specifik komponent och utdatasökväg använder du följande kommando:
.\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\temp\rmt-report.txt
Ytterligare alternativ
Använd följande alternativ för att anpassa kontrollen före uppgradering:
-Component
Ange RMT Server eller Agent. Skriptet detekterar detta automatiskt om det utelämnas.
--db-password / -DbPassword
Administratörslösenordet för den interna RMT-databasen. Krävs för PostgreSQL-kontroller.
--output / -OutputPath
Ange var rapporten ska sparas. Som standard sparas den till /tmp/ (Linux) or C:\temp\ (Windows).
--target-version / -TargetVersion
Den RMT-version du planerar att installera. Aktiverar versionsspecifika kontroller.
--quiet / -Quiet
Filtrerar utdata för att endast visa FAIL- och WARN-resultat.
--verbose / -Verbose
Utdata visar detaljerade tekniska data för varje utförd kontroll.
Skriptresultat och nödvändiga åtgärder
I följande tabell beskriver vi skriptresultat och åtgärder:
| Resultat | Status | Åtgärd |
| PASS | SLUTKOD 0 | Inga problem hittades. Uppgraderingen fortsätter. |
| WARN | SLUTKOD 1 | Uppgraderingen fortsätter, men du måste granska rapporten avseende icke-kritiska risker. |
| FAIL | SLUTKOD 2 | Uppgraderingen avbröts. Du måste åtgärda de här problemen innan du kör uppgraderingen igen. |
Skript efter uppgradering
Hälsokontrollskripten efter uppgradering körs automatiskt i slutet av varje installation och uppgradering av RMT. De verifierar att alla tjänster har startats korrekt, att infrastrukturen är felfri och att konfigurationen är intakt. Kontrollen efter uppgradering blockerar inte installationsprogrammet. Alla identifierade fel registreras i slutrapporten.
Manuell kontroll efter uppgradering
Använd följande steg för att köra skriptet manuellt, baserat på ditt operativsystem:
För Linux:
Kör följande kommandon som en rotanvändare eller med sudo-behörigheter:
För RMT Server:
sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade
För Agent:
sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade
För Windows:
Kontrollfilerna för RMT Server installeras som standard på följande plats:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1
Kontrollfilerna för Agent installeras som standard på följande plats:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1
Om du vill köra skripten manuellt öppnar du PowerShell som administratör och går till RMT-installationskatalogen innan du kör kommandona:
För RMT Server:
.\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade
För Agent:
.\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade
Ytterligare alternativ
Du kan använda följande alternativ för att anpassa skriptet:
--component / -Component
Ange RMT Server eller Agent. Skriptet försöker automatiskt att detektera detta om det utelämnas.
--db-password / -DbPassword
Lösenordet för den interna RMT-databasadministratören. Detta krävs för att aktivera PostgreSQL-kontroller.
--output / -OutputPath
Sökvägen där rapportfilen ska sparas. Standardvärdet är /tmp/ (Linux) eller C:\temp\ (Windows).
--target-version / -TargetVersion
Den specifika RMT-versionen som du uppgraderar till används för versionsspecifika kontroller.
--quiet / -Quiet
Minskar utdata för att endast visa FAIL- och WARN-resultat.
--verbose / -VerboseOutput
Ger detaljerad tekniska utdata för varje utförd kontroll.
Vi rekommenderar att du anger RMT_DB_PASSWORD som en miljövariabel i stället för att skicka den via kommandoraden, eftersom kommandoradsargument visas i processlistan.
Skriptresultat och nödvändiga åtgärder
I följande tabell beskriver vi skriptresultat och åtgärder:
| Resultat | Status | Åtgärd |
| PASS | SLUTKOD 0 | Systemet är felfritt. Ingen åtgärd krävs. |
| WARN | SLUTKOD 1 | Granska varningarna. De flesta löser sig av sig själva (t.ex. övergående fördröjning av RabbitMQ-start). |
| FAIL | SLUTKOD 2 | En eller flera kritiska kontroller misslyckades – undersök och kör igen. |
Rapporter
Rapporterna före uppgradering sparas här:
Linux:
/tmp/rmt-precheck-<timestamp>.txtWindows (manuellt):
C:\temp\rmt-precheck-<component>-<timestamp>.txt
Rapporterna efter uppgradering sparas här:
Linux:
<log-dir>/rmt-postcheck-report.txtWindows (manuellt):
C:\temp\rmt-postcheck-<component>-<timestamp>.txtWindows (via installationsprogrammet): När installationsprogrammet kör kontrollen används fasta filnamn:
C:\temp\rmt-postcheck-master-report.txtC:\temp\rmt-postcheck-agent-report.txt
Mer information om kontroller före och efter uppgradering i rapporten finns i avsnittet Referens för uppgradering.
Exempelrapport
Följande är ett exempel på en hälsokontrollrapport före uppgradering:
==================================================================
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
