Hilfe zu Tableau Server für Windows

Ab Version 2025.3.6 enthält das RMT-Installationsprogramm ein Pre-Upgrade-Skript und ein Post-Upgrade-Skript zur Integritätsprüfung, um Ihre RMT-Umgebung (Tableau Resource Monitoring Tool) vor und nach dem Upgrade zu überprüfen. Diese Skripte identifizieren bereits vorhandene Probleme in Ihrer Umgebung, wie z. B. Fehlkonfigurationen, Berechtigungsabweichungen, Speicherplatzengpässe, abgelaufene Zertifikate oder Dienstfehler, die beim Upgrade Fehler verursachen können.

Die Pre- und Post-Upgrade-Skripte der Integritätsprüfung können die folgenden Probleme erkennen:

• Datenbank- und Festplattenbereitschaft: Erkennt, ob eine große Datenbank oder zu viele WAL-Dateien dazu führen, dass die Migration nicht durchgeführt werden kann oder nicht genügend Festplattenspeicherplatz vorhanden ist.

• Berechtigungs- und Sicherheitsintegrität: Identifiziert geänderte Dateibesitzverhältnisse oder abgelaufene SSL-Zertifikate, die andernfalls den Neustart von Diensten oder die erneute Verbindung von Agenten blockieren würden.

• Abhängigkeitsüberprüfung: Stellt sicher, dass erforderliche Windows-Komponenten wie Visual C++ 2022 Redistributable und OpenSSL 3.x vorhanden sind, bevor PostgreSQL 15 installiert wird.

• Versionslogik-Sicherheit: Verhindert Downgrade-Fehlalarme, die durch Versionsmetadaten-Regressionen verursacht werden.

Pre-Upgrade-Skript

Das Pre-Upgrade-Skript wird automatisch ausgeführt, wenn Sie ein Upgrade starten. Es untersucht Ihren RMT-Server oder Agent-Host, solange die vorhandene Installation noch intakt ist, und generiert einen PASS-/FAIL-/WARN-Bericht.

Unter Linux wird die Überprüfung vor dem Upgrade automatisch als Teil folgender Schritte ausgeführt:

sudo bash upgrade-rmt-master ...

sudo bash upgrade-rmt-agent ...

So überspringen Sie die automatische Überprüfung (nicht empfohlen):

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

Unter Windows führt das Installationsprogramm die Überprüfung vor dem Upgrade automatisch durch. Während der Installation wird Ihnen auch die Option zum Überspringen des Upgrades angezeigt. Dies wird jedoch nicht empfohlen.

Manuelle Pre-Upgrade-Überprüfung

Sie können das Skript manuell ausführen, um eine Vorschau potenzieller Probleme anzuzeigen. Führen Sie zum manuellen Ausführen die folgenden Schritte entsprechend Ihrem Betriebssystem aus:

Unter Linux:

Führen Sie die Befehle als Root-Benutzer aus. Verwenden Sie den Befehl „export“, um Datenbanküberprüfungen einzubeziehen und um Ihr Kennwort sicher zu übergeben.

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

Verwenden Sie den folgenden Befehl, um PostgreSQL-Prüfungen zu aktivieren:

export RMT_DB_PASSWORD="<tabrmtdb-password>"

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

Verwenden Sie den folgenden Befehl zum Ausführen mit einer bestimmten Komponente und einem bestimmten Ausgabepfad:

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

Unter Windows:

Die Pre-Upgrade-Dateien für den RMT-Server werden standardmäßig an folgendem Speicherort installiert:

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

Die Pre-Upgrade-Dateien für den Agenten werden standardmäßig an folgendem Speicherort installiert:

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

Um das Skript manuell auszuführen, starten Sie PowerShell als Administrator und führen Sie Folgendes aus:

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

.\rmt-pre-upgrade-check.ps1

Verwenden Sie den folgenden Befehl, um PostgreSQL-Prüfungen zu aktivieren:

$env:RMT_DB_PASSWORD = "<tabrmtdb-password>"

.\rmt-pre-upgrade-check.ps1

Verwenden Sie den folgenden Befehl zum Ausführen mit einer bestimmten Komponente und einem bestimmten Ausgabepfad:

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

Zusätzliche Optionen

Verwenden Sie die folgenden Optionen, um die Pre-Upgrade-Überprüfung anzupassen:

-Component

Geben Sie den RMT-Server oder Agenten an. Wenn diese Angaben nicht gemacht werden, werden sie automatisch vom Skript erkannt.

--db-password / -DbPassword

Das interne Administratorkennwort für die RMT-Datenbank. Erforderlich für PostgreSQL-Prüfungen.

--output / -OutputPath

Geben Sie an, wo der Bericht gespeichert werden soll. Die Standardeinstellung ist /tmp/ (Linux) or C:\temp\ (Windows).

--target-version / -TargetVersion

Die RMT-Version, die Sie installieren möchten; aktiviert versionsspezifische Überprüfungen.

--quiet / -Quiet

Filtert die Ausgabe, sodass nur die Ergebnisse FAIL und WARN angezeigt werden.

--verbose / -Verbose

Die Ausgabe enthält detaillierte technische Daten für jede durchgeführte Prüfung.

Skriptergebnisse und erforderliche Aktionen

In der folgenden Tabelle werden das Skriptergebnis und die Aktion erläutert:

Post-Upgrade-Skript

Die Post-Upgrade-Skripte für die Integritätsprüfung werden automatisch am Ende jeder RMT-Installation und jedes Upgrades ausgeführt. Dabei wird überprüft, ob alle Dienste korrekt gestartet wurden, die Infrastruktur fehlerfrei ist und die Konfiguration intakt ist. Die Post-Upgrade-Überprüfung blockiert das Installationsprogramm nicht. Alle festgestellten Fehler werden im Abschlussbericht festgehalten.

Manuelle Post-Upgrade-Überprüfung

Führen Sie zum manuellen Ausführen die folgenden Schritte entsprechend Ihrem Betriebssystem aus:

Unter Linux:

Führen Sie die folgenden Befehle als Root-Benutzer oder mit sudo-Zugriffsrechten aus:

• Für den RMT-Server:

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

• Für den Agenten:

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

Unter Windows:

Die Post-Upgrade-Dateien für den RMT-Server werden standardmäßig an folgendem Speicherort installiert:

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

Die Post-Upgrade-Dateien für den Agenten werden standardmäßig an folgendem Speicherort installiert:

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

Öffnen Sie zum manuellen Ausführen der Skripts PowerShell als Administrator, und navigieren Sie zu Ihrem RMT-Installationsverzeichnis. Führen Sie dann die Befehle aus:

• Für den RMT-Server:

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

• Für den Agenten:

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

Zusätzliche Optionen

Mit den folgenden Option können Sie das Skript anpassen:

--component / -Component

Geben Sie den RMT-Server oder Agenten an. Wenn diese Angaben nicht gemacht werden, versucht das Skript automatisch, sie zu erkennen.

--db-password / -DbPassword

Das Kennwort für den internen RMT-Datenbankadministrator. Dies ist erforderlich, um PostgreSQL-Überprüfungen zu aktivieren.

--output / -OutputPath

Der Pfad, in dem die Berichtsdatei gespeichert wird. Ist standardmäßig festgelegt mit /tmp/ (Linux) oder C:\temp\ (Windows).

--target-version / -TargetVersion

Die RMT-Version, auf die Sie ein Upgrade durchführen und die für versionsspezifische Überprüfungen verwendet wird.

--quiet / -Quiet

Schränkt die Ausgabe ein, sodass nur FAIL- und WARN-Ergebnisse angezeigt werden.

--verbose / -VerboseOutput

Liefert eine detaillierte technische Ausgabe für jede durchgeführte Prüfung.

Hinweis: Es wird empfohlen, RMT_DB_PASSWORD als Umgebungsvariable festzulegen, statt sie in die Befehlszeile einzugeben, da Befehlszeilenargumente in der Prozessliste sichtbar sind.

Skriptergebnisse und erforderliche Aktionen

In der folgenden Tabelle werden das Skriptergebnis und die Aktion erläutert:

Berichte

Die Pre-Upgrade-Berichte finden Sie hier:

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

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

Die Post-Upgrade-Berichte finden Sie hier:

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

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

• Windows (über das Installationsprogramm): Wenn das Installationsprogramm die Prüfung ausführt, verwendet es feststehende Dateinamen:

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

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

  Informationen zu Pre- und Post-Upgrade-Überprüfungen im Bericht finden Sie im Abschnitt Upgrade-Referenz .

Beispielbericht

Im Folgenden finden Sie einen Beispielbericht für eine Pre-Upgrade-Integritätsprüfung:

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