Scripts voor RMT-statuscontrole voor en na upgrades

Is van toepassing op: Tableau Advanced Management

Vanaf release 2025.3.6 bevat het RTM-installatieprogramma een script voor statuscontrole vóór en na een upgrade om uw Tableau Resource Monitoring Tool (RMT)-omgeving vóór en na upgrades te valideren. Deze scripts identificeren reeds bestaande problemen in uw omgeving, zoals onjuiste configuratie, afwijking van machtigingen, te weinig schijfruimte, verlopen certificaten of servicefouten die eerder aanwezig waren en een upgradefout kunnen veroorzaken.

De scripts voor statuscontrole vóór en na een upgrade kunnen de volgende problemen identificeren:

  • Gereedheid van database en schijf: stelt vast of een grote database of overtollige WAL-bestanden ertoe leiden dat de migratie vastloopt of te veel schijfruimte in beslag nemen.

  • Machtigings- en beveiligingsintegriteit: identificeert gewijzigd bestandseigendom of verlopen SSL-certificaten die anders het herstarten van services zouden blokkeren of zouden voorkomen dat agents opnieuw verbinding kunnen maken.

  • Afhankelijkheidsvalidatie: zorgt ervoor dat de vereiste Windows-componenten, zoals het herdistribueerbare pakket voor Visual C++ 2022 en OpenSSL 3.x, aanwezig zijn voordat PostgreSQL 15 wordt geïnstalleerd.

  • Beveiliging van versielogica: voorkomt 'false downgrade'-fouten die worden veroorzaakt door regressies van versiemetadata.

Script voor controle vóór een upgrade

Het script voor controle vóór een upgrade wordt automatisch uitgevoerd wanneer u een upgrade start. Het inspecteert uw RMT Server of Agent-host terwijl de bestaande installatie nog intact is en genereert een PASS/FAIL/WARN-rapport.

Voor Linux wordt de controle vóór een upgrade automatisch uitgevoerd als onderdeel van:

sudo bash upgrade-rmt-master ...
sudo bash upgrade-rmt-agent ...

De automatische controle overslaan (niet aanbevolen):

sudo bash upgrade-rmt-master --skip-pre-upgrade-check ...

Voor Windows voert het installatieprogramma de controle vóór een upgrade automatisch uit. Tijdens de installatie krijgt u ook de mogelijkheid om de upgrade over te slaan. Dit wordt echter afgeraden.

Handmatige controle vóór een upgrade

U kunt het script handmatig uitvoeren om mogelijke problemen vooraf te bekijken. Als u het script handmatig wilt uitvoeren, gebruikt u de volgende stappen op basis van uw besturingssysteem:

Voor Linux:

Voer de opdrachten uit als rootgebruiker. Als u databasecontroles wilt opnemen, gebruikt u de exporteeropdracht om uw wachtwoord veilig door te geven.

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh

Als u het script wilt uitvoeren met PostgreSQL-controles ingeschakeld, gebruikt u de volgende opdracht:

export RMT_DB_PASSWORD="<tabrmtdb-password>"
sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh

Als u het script met een specifiek component en uitvoerpad wilt uitvoeren, gebruikt u de volgende opdracht:

sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt

Voor Windows:

De bestanden voor RMT Server van voor de upgrade worden standaard op de volgende locatie geïnstalleerd:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1

De bestanden voor Agent van voor de upgrade worden standaard op de volgende locatie geïnstalleerd:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1

Als u het script handmatig wilt uitvoeren, start u PowerShell als beheerder en voert u het volgende uit:

cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"

.\rmt-pre-upgrade-check.ps1

Als u het script wilt uitvoeren met PostgreSQL-controles ingeschakeld, gebruikt u de volgende opdracht:

$env:RMT_DB_PASSWORD = "<tabrmtdb-password>"
.\rmt-pre-upgrade-check.ps1

Als u het script met een specifiek component en uitvoerpad wilt uitvoeren, gebruikt u de volgende opdracht:

.\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\temp\rmt-report.txt

Extra opties

Gebruik de volgende opties om de controle vóór een upgrade aan te passen:

-Component

Geef RMT Server of Agent op. Het script detecteert deze automatisch als de informatie wordt weggelaten

--db-password / -DbPassword

Het interne RMT-beheerderswachtwoord van de database. Vereist voor PostgreSQL-controles.

--output / -OutputPath

Geef aan waar u het rapport wilt opslaan. Standaard wordt dit opgeslagen in /tmp/ (Linux) or C:\temp\ (Windows).

--target-version / -TargetVersion

De RMT-versie die u van plan bent te installeren; maakt versiespecifieke controles mogelijk.

--quiet / -Quiet

Filtert de uitvoer, zodat alleen de resultaten FAIL en WARN worden weergegeven.

--verbose / -Verbose

De uitvoer bevat gedetailleerde technische data voor elke uitgevoerde controle.

Scriptresultaten en vereiste acties

In de volgende tabel worden het scriptresultaat en de actie uitgelegd:

ResultaatStatusActie
PASSEXIT CODE 0Geen problemen gevonden. De upgrade gaat door.
WARNEXIT CODE 1De upgrade gaat door, maar u moet het rapport controleren op niet-kritieke risico's.
FAILEXIT CODE 2De upgrade is afgebroken. U moet deze problemen oplossen voordat u de upgrade opnieuw uitvoert.

Script voor controle na een upgrade

De scripts voor statuscontrole na een upgrade worden automatisch uitgevoerd aan het einde van elke RMT-installatie en -upgrade. Het script controleert of alle services correct zijn gestart, of de infrastructuur in orde is en of de configuratie intact is. De controle na een upgrade blokkeert het installatieprogramma niet. Alle vastgestelde fouten worden vastgelegd in het eindrapport.

Handmatige controle na upgrade

Als u het script handmatig wilt uitvoeren, gebruikt u de volgende stappen op basis van uw besturingssysteem:

Voor Linux:

Voer de volgende opdrachten uit als rootgebruiker of met sudo-bevoegdheden:

  • Voor RMT Server:

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade

  • Voor Agent:

sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade

Voor Windows:

De bestanden van na een upgrade voor RMT Server worden standaard op de volgende locatie geïnstalleerd:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1

De bestanden van na een upgrade voor Agent worden standaard op de volgende locatie geïnstalleerd:

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1

Als u de scripts handmatig wilt uitvoeren, opent u PowerShell als beheerder en navigeert u naar de RMT-installatiedirectory voordat u de opdrachten uitvoert:

  • Voor RMT Server:

.\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade

  • Voor Agent:

.\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade

Extra opties

U kunt de volgende opties gebruiken om het scrip aan te passen:

--component / -Component

Geef RMT Server of Agent op. Het script probeert deze informatie automatisch te detecteren als deze ontbreekt.

--db-password / -DbPassword

Het wachtwoord voor de interne RMT-databasebeheerder. Dit is nodig om PostgreSQL-controles mogelijk te maken.

--output / -OutputPath

Het pad waar het rapportbestand wordt opgeslagen. Standaard is dit /tmp/ (Linux) of C:\temp\ (Windows).

--target-version / -TargetVersion

De specifieke RMT-versie waarnaar u een upgrade uitvoert en die wordt gebruikt voor versiespecifieke controles.

--quiet / -Quiet

Beperkt de uitvoer, zodat alleen de resultaten FAIL en WARN worden weergegeven.

--verbose / -VerboseOutput

Biedt gedetailleerde technische uitvoer voor elke uitgevoerde controle.

Opmerking: we raden u aan om RMT_DB_PASSWORD in te stellen als een omgevingsvariabele in plaats van deze door te geven aan de opdrachtregel, omdat opdrachtregelargumenten zichtbaar zijn in de proceslijst.

Scriptresultaten en vereiste acties

In de volgende tabel worden het scriptresultaat en de actie uitgelegd:

ResultaatStatusActie
PASSEXIT CODE 0Systeem is in orde. Geen actie vereist
WARNEXIT CODE 1Bekijk de waarschuwingen; de meeste worden vanzelf opgelost (bijv. tijdelijke vertraging bij het starten van RabbitMQ).
FAILEXIT CODE 2Een of meerdere kritieke controles zijn mislukt. Onderzoek deze en los ze op.

Rapporten

U kunt de rapporten van vóór de upgrade hier vinden:

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

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

U kunt de rapporten van na de upgrade hier vinden:

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

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

  • Windows (via installatieprogramma): wanneer het installatieprogramma de controle uitvoert, gebruikt het vaste bestandsnamen:

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

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

    Zie het gedeelte Upgrade-referentie voor informatie over de controles vóór en na een upgrade in het rapport.

Voorbeeldrapport

Hieronder ziet u een voorbeeld van een statuscontrolerapport van vóór een upgrade:

==================================================================
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

 

 

 

 

Terug naar boven
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.