RMT-Upgrade: Technische Referenz

Dieser Abschnitt dient als technische Referenz für die Betriebsgrenzwerte, Systempfade und Netzwerkports, die während des Upgrade-Prozesses geprüft werden. Nutzen Sie diese Tabellen, um Validierungsfehler schnell zu diagnostizieren und Ihre Umgebung an die erforderlichen RMT-Basisanforderungen anzupassen.

Hinweis: Um unseren Unternehmenswerten in Bezug auf Gleichstellung gerecht zu werden, haben wir die Bezeichnung „RMT Master“ in „RMT-Server“ geändert. In einigen Fällen wird in RMT-Server-Installationspfaden und -befehlen aber weiterhin der Begriff „Master“ anstelle von „Server“ verwendet. Daher werden Sie den Begriff möglicherweise weiterhin in Befehlen und Optionen der Kommandozeile (CLI), in Installationsordnern, in Konfigurationsdateien und anderen Instanzen finden. Weitere Informationen finden Sie unter Über Tableau-Hilfe(Link wird in neuem Fenster geöffnet).

Pre-Upgrade-Integritätsprüfungen

Bei der Integritätsprüfung vor dem Upgrade wird Ihr RMT-Server oder Agent-Host überprüft, während die vorhandene Installation noch intakt ist. Beispielsweise wird überprüft, ob Dienste ausgeführt werden und auf die Datenbank zugegriffen werden kann. Anschließend wird ein detaillierter PASS-/FAIL-/WARN-Bericht erstellt. Dabei werden über 80 einzelne Überprüfungen von Systemressourcen, Konten, Dateiberechtigungen, PostgreSQL, RabbitMQ, Netzwerken, Konfigurationsdateien und RMT-Diensten durchgeführt. In der folgenden Tabelle sind die Überprüfungen aufgeführt, die vor dem Upgrade durchgeführt werden. Wenn eine Komponente den Status FAIL (Exit Code 2) zurückgibt, wird das Upgrade abgebrochen.

System und Hardware

Prüfungs-IDName PlattformenFehler (FAIL) / Warnung (WARN)
#1BetriebssystemLinux, WindowsWARN Die Betriebssystemversion ist nicht in der Zulassungsliste für die Pre-Upgrade-Überprüfung enthalten. Die unterstützte Liste enthält 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, Windows Server 2019/2022
#2DatenträgerspeicherplatzLinux, WindowsFAIL RMT-Server < 20 GB oder Agent < 5 GB frei. WARN RMT-Server < 50 GB oder Agent < 10 GB frei
#2aDatenträgertypLinux, WindowsINFO Gibt an, ob es sich bei dem Laufwerk um eine SSD oder HDD handelt
#3

RAM

Linux, WindowsWARN RMT-Server < 8 GB (Minimum) oder Agent < 4 GB (Minimum)
#4CPU-KerneLinux, WindowsWARN RMT-Server < 8 GB (Minimum) oder Agent < 4 GB (Minimum)
#4aCPU-AnweisungenLinux, WindowsFAIL (Linux): Fehlende sse4_2 oder popcnt. WARN (Windows): Ältere CPU erkannt.
#4bVC++ RedistWindowsFAIL Visual Studio 2022 C++ Redistributable fehlt.
#4cOpenSSL DLLsWindowsINFO Prüft das Vorhandensein von libcrypto-3-x64.dll und libssl-3-x64.dll
#5SystemverfügbarkeitLinux, WindowsINFO Meldet, wenn < 10 Minuten (kürzlicher Neustart) oder > 90 Tage (ausstehende Patches)
#6Systemd wird ausgeführtLinuxFAIL Systemd wird nicht ausgeführt, PASS Wird ausgeführt oder ist degradiert
#7FIPS-ModusLinux, WindowsFAIL (Windows) In der Registry aktiviert, PASS FIPS deaktiviert. WARN (Linux) Konflikt mit config.json. PASS Betriebssystem und Konfiguration stimmen überein
#7aPowerShell-VersionWindowsINFO PowerShell-Version
#7bGebietsschema des SystemsWindowsINFO Informationen zum Gebietsschema des Systems
#7cWMI-IntegritätWindowsWARN WMI-Repository ist inkonsistent

 

Konten und Berechtigungen

Prüfungs-IDName PlattformFehler (FAIL) / Warnung (WARN)
#8DienstkontoLinux, WindowsFAIL RMT-Dienstkonto oder Windows-Dienst nicht gefunden
#9GruppenmitgliedschaftLinuxFAIL Erforderliche Dienstgruppen (z. B. rmtmasterapp, rmtmasterconfig) fehlen
#10Benutzer-SystemdLinuxFAIL Benutzer-Systemd daemon/linger ist nicht aktiv
#44pamtester installiertLinuxWARN, wenn nicht installiert. Um dieses Problem zu beheben, installieren Sie yum install pamtester oder apt install libpam-runtime

Verzeichnisbesitz und -berechtigungen für Linux

Prüfungs-IDVerzeichnis Expected Owner:GroupErwarteter Modus
#11Konfigurationsverzeichnistabrmt-master:rmtmasterconfig2775
#12Protokollverzeichnistabrmt-master:rmtmasterlogs2775
#13Datenverzeichnis (+ PG/RMQ-Unterverzeichnisse)Komponenten-spezifisch2775
#14Erforderliche Verzeichnisseroot oder Komponentenbenutzer755
#14aDatei rabbitmq-defaultsMuss gruppenbeschreibbar seing+w
#15SSL-Zertifikatsverzeichnistabrmt-master:rmtopenssl2775
#15aHome-VerzeichnisKomponentenbenutzer770
#15b/etc/profile.d/tabrmt-*.shrootStandard
#15cSetgid-Bit im Konfigurationsverzeichnis--2xxx erforderlich
#16environment.bashKomponentenbenutzergroup-writable

Schweregrad: FAIL nur bei Besitz des Datenverzeichnisses (#13 und #15). Alle anderen Linux-Verzeichnisüberprüfungen (#11, #12, #14, #14a, #15a–c, #16) geben bei Nichtübereinstimmung von Besitz und Modus WARN aus, da das Installationsprogramm nach der Installation das Besitzrecht während des Upgrades erneut anwendet. WARN, wenn der Berechtigungsmodus falsch, der Besitz jedoch korrekt ist.

Verzeichnisbesitz und Berechtigungen für Windows

Prüfung NameSchweregrad
#11Config dir ACLsFAIL, wenn Dienstbenutzer nicht über FullControl verfügt
#12Log dir ACLsFAIL, wenn Dienstbenutzer nicht über Modify-Rechte verfügt
#13Data dir ACLs (RMT-Server)FAIL, wenn Dienstbenutzer nicht über FullControl bei PG/RMQ-Datenverzeichnissen verfügt
#14Prereqs dir ACLs (RMT-Server)WARN, wenn ReadAndExecute fehlt (als Empfehlung – bei jedem Upgrade werden die erforderlichen MSIs neu installiert, und die Post-Installationsaktionen wenden die ACLs erneut an)
#15SSL cert dir ACLs (RMT-Server)FAIL, wenn Dienstbenutzer nicht über FullControl verfügt
#16aIdentität des DienstbenutzersPASS (informativ – zeigt, unter welchem Benutzer der Dienst ausgeführt wird)
#16bSeServiceLogonRight privilegeINFO, wenn gefunden; WARN, wenn nicht gefunden oder secedit fehlschlägt
#16cDienstbenutzer-ACLs auf RMT-VerzeichnissenFAIL, wenn Dienstbenutzer nicht über die erforderlichen Rechte verfügt

 

Datenbank (PostgreSQL)

Alle PostgreSQL-Prüfungen werden nur auf dem RMT-Server ausgeführt.

Prüfungs-IDName Erfordert Option db-passwordFehler (FAIL) / Warnung (WARN)
#17PG-DienstNeinFAIL Lokaler Dienst angehalten UND deaktiviert
#18Port 5555 lauschtNeinWARN (Sicherheitsgruppe / VPC / RDS-Hinweis) lauscht nicht
#19DB ConnectionJaWARN Keine Verbindung zur internen Datenbank möglich (SSL-, Kennwort- oder Netzwerkproblem)

 

Messaging (RabbitMQ)

Die Messaging-Prüfungen (RabbitMQ) werden nur auf dem RMT-Server ausgeführt.

Prüfungs-IDName Fehler (FAIL) / Warnung (WARN)
#22RMQ-DienstFAIL Lokaler Dienst angehalten UND deaktiviert
#24WarteschlangenrückstandWARN Eine Warteschlange mit > 10.000 Nachrichten
#25RabbitMQ-BenutzerWARN, wenn der standardmäßige guest-Benutzer noch vorhanden ist
#26Aktive VerbindungenNur INFO. Meldet die Anzahl der aktiven Verbindungen
#27Erlang-Cookie zugänglichWARN, wenn die Cookie-Datei fehlt, wenn Berechtigungen falsch sind (sollte Modus 400 oder 600 sein)
#27aERLANG_HOME setWARN (nur Windows), wenn „ERLANG_HOME“ nicht festgelegt oder der Pfad nicht vorhanden ist.
#27bSSL-GültigkeitFAIL Zertifikate sind abgelaufen
#27cDatenträger-AlarmFAIL < 10 GB frei auf RMQ-Partition (Upgrade bleibt hängen)
#45Zertifikatsverzeichnis ausgefülltWARN, wenn das Zertifikatsverzeichnis zwar vorhanden, aber leer ist oder erwartete Zertifikatsdateien fehlen (Serverzertifikat, Schlüssel, CA-Zertifikat)

Netzwerk und Konfiguration

Prüfungs-IDName Fehler (FAIL) / Warnung (WARN)
#28a/bAgent-Master-KommunikationWARN Der Agent kann den Master unter 5671, 5672, 80 oder 443 nicht erreichen.
#33-35JSON/Bash ConfigFAIL Fehlende oder ungültige config.json, setup.json oder environment.bash
#36aBekannte fehlerhafte VersionFAIL Aktuelle Version ist 2025.3.0 (Upgrade für Regressionsblöcke)

Dienste und Backup

Prüfungs-IDName Fehler (FAIL) / Warnung (WARN)
#38Alle RMT-Dienste werden ausgeführtWARN für jeden gestoppten Dienst
#38aHängengebliebene ProzesseFAIL Verbliebene tabrmt-*-Prozesse gefunden, nachdem die Dienste angehalten wurden
#39Im Hintergrund ausgeführter ProzessorWARN, wenn der Hostprozess nicht ausgeführt wird
#40Sicherungserinnerung vor dem UpgradeWARN als Erinnerung daran, die Konfiguration vor dem Upgrade zu sichern
#41TopologieNur INFO. Meldet den Master/Agent-Knotentyp und (mit DB) die Anzahl der aktiven Agenten
#42Inventar der KomponentenversionenNur INFO. Meldet RMT-, PostgreSQL-, RabbitMQ- und OpenSSL-Versionen
#43Zusammenfassung der technischen Daten des ComputersNur INFO. Meldet Betriebssystem, CPU-Kerne, RAM, freien Festplattenspeicherplatz

 

Post-Upgrade-Integritätsprüfungen

Diese Überprüfungen werden nach dem Upgrade ausgeführt. Sie sind nicht blockierend, und Fehler stoppen das Upgrade nicht, weisen aber auf Probleme nach der Installation hin.

Prüfungs-IDName KomponenteFehler (FAIL) / Warnung (WARN)
#1a-dDienste und ProzesseRMT Server, AgentFAIL Haupt-, PG- oder RMQ-Dienste werden nicht ausgeführt
#2Host-Supervisor-ProzessRMT Server, AgentWARN Host-Supervisor-Prozess fehlt (keine automatische Wiederherstellung)
#3a-bIntegrität der KonfigurationsdateiRMT Server, AgentFAIL, falls fehlender oder ungültiger JSON
#4a-bDateiberechtigungenRMT Server, AgentFAIL Konfigurations-/Protokollverzeichnisse können vom Dienstkonto nicht gelesen/beschrieben werden
#5a-dPort lauschtRMT ServerFAIL Web (443), AMQP (5672) oder DB (5555) lauschen nicht
#6PostgreSQL-KonnektivitätRMT ServerFAIL PostgreSQL akzeptiert keine Verbindungen
#7RabbitMQ-StatusRMT-ServerSKIP, wenn extern. FAIL, nachdem alle Wiederholungen ausgeschöpft sind.
#8aKonsumenten in WarteschlangeRMT ServerWARN Backlog vorhanden, aber keine aktiven Konsumenten (Master-Worker-Prozesse getrennt)
#9RMQ-AlarmeRMT ServerFAIL Alarme für aktiven Arbeitsspeicher oder Festplattenressource erkannt
#10RabbitMQ SSL-ZertifikatRMT-ServerFAIL, wenn Zertifikat abgelaufen ist. WARN, wenn Zertifikate innerhalb von 30 Tagen ablaufen
#11FIPS-ÜbereinstimmungRMT Server, AgentFAIL Der FIPS-Status des Betriebssystems stimmt nicht mit isFIPSEnabled config überein
#12HTTP-Antwort des WebserversRMT-ServerSendet eine HTTP GET-Abfrage an https://localhost:<port>/authentication/login. PASS auf 200 oder 302. FAIL bei Verbindungsverweigerung/Zeitüberschreitung. WARN bei anderen Fehlern.
#13Gültigkeit des HTTPS-ZertifikatsRMT ServerFAIL Webserver-TLS-Zertifikat ist abgelaufen
#14a-dDatenträgerspeicherplatzRMT Server, AgentFAIL < 1 GB frei. WARN < 5 GB frei
#15Kürzliche ProtokollfehlerRMT Server, AgentFAIL SCHWERWIEGENDE Fehler in Protokollen. WARN KRITISCHE FEHLER
#16RMT-StatusRMT Server, AgentFAIL rmtadmin-Status gibt Fehlermuster zurück
#17AgentenprotokollverlaufAgentÜberprüft die Log-Tracking-Dateien (.history, .json) im Agenten-Datenverzeichnis. WARN, wenn Dateien nicht lesbar oder beschädigt sind
#18a-fInventarversionRMT Server, AgentINFO über RMT-Version, PostgreSQL-Version, RabbitMQ-Version, Erlang/OTP-Version, .NET Runtime (Windows) / OS (Linux), OS-Version (Windows) / Kernel (Linux)

Exit Codes der Integritätsprüfung

Anhand der folgenden Exit Codes können Sie die Ergebnisse der Pre-Upgrade- und Post-Upgrade-Integritätsprüfungsskripte interpretieren.

Pre-Upgrade-Skripte

Exit CodeStatus Upgrade-Verhalten
0READY TO UPGRADEUpgrade wird fortgesetzt
1UPGRADE WITH CAUTIONUpgrade wird fortgesetzt; Warnungen überprüfen
2Kein Upgrade durchführenUpgrade abgebrochen
3SkriptfehlerAusführungsumgebung prüfen

Post-Upgrade-Skripte

Exit CodeStatus
0ALL PASSED
1WARNINGS PRESENT
2CRITICAL FAILURES

Änderungen des InstallerContext-Schweregrads

Bei Verwendung von -InstallerContext während automatischer Windows-MSI-Upgrades verhalten sich die folgenden Prüfungen anders als im manuellen Standardfall. Das Standardverhalten (nicht InstallerContext) ist für die Zustände „stopped but not Disabled“ (Angehalten, aber nicht deaktiviert) / „port not listening“ (Port lauscht nicht) *bereits* WARN; FAIL ist für „Stopped+Disabled“ (Angehalten + deaktiviert) reserviert. Unter -InstallerContext wird sogar der „Disabled“-Zweig als WARN ausgegeben, sodass ein laufendes, vom Installationsprogramm gesteuertes Upgrade nicht durch einen temporären Zustand blockiert wird, der ohnehin vom Installationsprogramm selbst korrigiert wird.

Prüfung Name StandardInstallerContext
#17PG-DienstWARN, wenn angehalten, FAIL, wenn angehalten und deaktiviert, INFO, wenn alle angehalten wurdenWARN
#18PG-PortWARN, wenn nicht lauscht, INFO, wenn alle Dienste angehalten wurdenWARN
#22RabbitMQ-DienstWARN, wenn angehalten , FAIL, wenn angehalten und deaktiviert, INFO, wenn alle angehalten wurdenWARN
#23Port 5672 (AMQP)WARN, wenn nicht lauscht, INFO, wenn alle Dienste angehalten wurdenWARN
#38aHängengebliebene RMT-Prozesse(siehe Beschreibung der Prüfung)SKIP (Installationsprogramm verwaltet den Prozesslebenszyklus)

Pre-Upgrade-Schwellenwerte

Schwellenwert RMT Server AgentEinheit
FAIL bei Festplattenspeicherplatz205GB frei
WARN bei Festplattenspeicherplatz5010GB frei
FAIL bei temporärem Verzeichnis55GB frei
WARN bei temporärem Verzeichnis1010GB frei
FAIL bei RAM84GB
WARN bei RAM168GB
FAIL bei CPU42Kerne
WARN bei CPU84Kerne
FAIL bei Datenbankgröße500GB
WARN bei Datenbankgröße200GB
FAIL bei Hangfire-Schema10GB
WARN bei Hangfire-Schema1GB
FAIL bei WAL-Verzeichnis (Windows)10GB
FAIL bei WAL-Verzeichnis (Windows)2GB
FAIL bei WAL-Verzeichnis (Linux)10GB
WARN bei Mnesia-Verzeichnis5GB
FAIL bei RabbitMQ-Datenträgeralarm10GB frei
WARN bei Warteschlangenrückstand10.000Nachrichten
WARN bei Ablauf des Zertifikats3030Tage
WARN bei Bereinigungs-Aufbewahrung180Tage
WARN bei Anteil toter Tupel20Prozent
Agent-Heartbeat veraltet15Minuten
WARN bei Alter des Netzwerktreibers3Jahre
WARN bei Größe des Protokollverzeichnisses55GB
WARN bei Größe des Protokollverzeichnisses (schwerwiegend)2020GB

Post-Upgrade-Schwellenwerte

SchwellenwertWert Einheit
FAIL bei Festplattenspeicherplatz1GB frei
WARN bei Festplattenspeicherplatz5GB frei
WARN bei Ablauf des Zertifikats30Tage
WARN bei Warteschlangenrückstand10.000Nachrichten
Zeitfenster für Log-Scan60Minuten
RabbitMQ-Startwiederholung6 Versuche x 5 Sek.Insg. 30 Sekunden

 

Unterstützte Komponenten-Mindestversionen

KomponenteMindestversion
RabbitMQ>= 3.10.10
Agent-Version>= 2023.1.0

Automatisierung und CI/CD-Integration

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

Unter Windows:

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

 

Referenz für das Installationsverzeichnis

Informationen zum manuellen Aufrufen der zugrunde liegenden Diagnosedienstprogramme oder zum Überprüfen Ihrer Installationsstruktur finden Sie in den plattformspezifischen Verzeichnispfaden:

Linux-Verzeichnisstruktur

```

/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

```

Windows-Verzeichnisstruktur

```

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

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

```

Erforderliche Netzwerkports

PortDienst Richtung
80RMT-Webschnittstelle (HTTP)Eingehend
443RMT-Webschnittstelle (HTTPS)Eingehend
5672RabbitMQ-AMQPEingehender Datenverkehr auf dem RMT-Server
5671RabbitMQ AMQP über TLSEingehender Datenverkehr auf dem RMT-Server
15672RabbitMQ-VerwaltungsoberflächeLokal
25672RabbitMQ-ZwischenknotenLokal
5555Internes PostgreSQLLokal
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.