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:

ResultatStatusÅtgärd
PASSSLUTKOD 0Inga problem hittades. Uppgraderingen fortsätter.
WARNSLUTKOD 1Uppgraderingen fortsätter, men du måste granska rapporten avseende icke-kritiska risker.
FAILSLUTKOD 2Uppgraderingen 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:

ResultatStatusÅtgärd
PASSSLUTKOD 0Systemet är felfritt. Ingen åtgärd krävs.
WARNSLUTKOD 1Granska varningarna. De flesta löser sig av sig själva (t.ex. övergående fördröjning av RabbitMQ-start).
FAILSLUTKOD 2En eller flera kritiska kontroller misslyckades – undersök och kör igen.

Rapporter

Rapporterna före uppgradering sparas här:

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

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

Rapporterna efter uppgradering sparas här:

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

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

  • Windows (via installationsprogrammet): När installationsprogrammet kör kontrollen används fasta filnamn:

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

    • C:\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

 

 

 

 

Tack för din feedback!Din feedback har skickats in. Tack!