Server-Upgrade – Erfassen von Konfigurationsdetails
Wenn Sie ein direktes Upgrade durchführen (also ein Upgrade ohne Aktualisierung der Hardware), bleiben fast alle Konfigurationsdaten erhalten. Streng genommen müssen Sie in diesem Fall nicht alle Konfigurationsinformationen erfassen. Es wird jedoch empfohlen, die in diesem Thema beschriebenen Informationen zu sammeln. Im schlimmsten Fall – also bei einem Fehlschlag des Upgrades – haben Sie so einen Datensatz aller Konfigurationsinformationen, falls Sie diese wiederherstellen müssen. In jedem Fall können Sie die von Ihnen erfassten Konfigurationsdetails verwenden, um das Upgrade nach Abschluss zu überprüfen.
Aufnehmen von Screenshots
Eine relativ schnelle Möglichkeit, die Grundlagen Ihrer Konfiguration zu erfassen, besteht darin, Screenshots der Seiten Ihrer TSM-Webschnittstelle sowie des Tableau Server-Administrationsbereichs zu erstellen.
Klicken Sie sich durch alle sichtbaren Seiten und nehmen Sie Screenshots auf:
- Anmelden bei der Webschnittstelle von Tableau Services Manager.
- Anmelden beim Administrationsbereich von Tableau Server.
Aufzeichnen der Objektanzahl
Wenn Sie sich im Tableau Server-Administratorbereich befinden, zählen und notieren Sie Folgendes für jede Site:
- Projekte, Arbeitsmappen, Ansichten und Datenquellen
- Benutzer und Gruppen
Erfassen von Asset-Dateien
Viele der unterstützenden Dateien (Zertifikate, IdP-Metadaten, Logos usw.), die Sie auf Tableau Server hochladen, sind nach dem Hochladen nicht mehr mit TSM zugänglich. Insbesondere werden Dateien, die vom Client-Dateidienst hochgeladen und verwaltet werden, umbenannt und verschleiert, bevor sie an die Bereitstellung verteilt werden. Bei diesem Prozess werden auch die Dateiattribute parametrisiert, die von Tableau-Diensten benötigt werden. Daher werden Dateien für die folgenden Dateien nicht einem einzelnen Dateispeicherort im Dateisystem zugeordnet. Wenn Sie eine der folgenden Dateien hochgeladen haben, müssen Sie Kopien davon auf dem Computer speichern, auf dem Tableau Server ausgeführt wird:
- SAML-Zertifikatsdatei
- SAML-Schlüsseldatei
- SAML IdP Metadaten-Datei
- OpenID.static.file
- Kerberos.keytab-Datei
- LDAP Kerberos Keytab-Datei
- LDAP Kerberos Konfigurationsdatei
- Gegenseitige SSL-Zertifikatsdatei
- Gegenseitige SSL-Widerrufsdatei
- Anpassung der Header-Logodatei
- Anpassung Anmelde-Logo-Datei
- Anpassung kompakte Logo-Datei
Erfassen der benutzerdefinierten Konfigurationsinformationen
Einige Konfigurationsinformationen werden auf den TSM- oder Tableau Server-Webseiten nicht angezeigt. Dieser Abschnitt enthält Konfigurationsdetails, die Sie möglicherweise erfassen müssen, je nachdem, wie Sie Ihre Tableau-Bereitstellung angepasst haben.
Sicheres SMTP
Wenn Sie TLS für Tableau Server konfiguriert haben, müssen Sie die TLS-bezogenen Konfigurationen aufzeichnen, die nicht in der E-Mail-Server-Konfiguration der TSM-Webschnittstelle enthalten sind.
Um die TLS-bezogenen Konfigurationen zu erfassen, müssen Sie tsm configuration get
mit den folgenden Schlüsselwerten ausführen:
svcmonitor.notification.smtp.ssl_enabled
svcmonitor.notification.smtp.ssl_required
svcmonitor.notification.smtp.ssl_check_server_identity
svcmonitor.notification.smtp.ssl_trust_all_hosts
svcmonitor.notification.smtp.ssl_ciphers
svcmonitor.notification.smtp.ssl_versions
Führen Sie beispielsweise den folgenden Befehl aus, um die Liste der Verschlüsselungen abzurufen, die für SMTP TLS konfiguriert sind:
tsm configuration get -k svcmonitor.notification.smtp.ssl_ciphers
Weitere Informationen zu den obigen Schlüsseln finden Sie im Abschnitt zur TSM-Befehlszeile in Konfigurieren des SMTP-Setups.
Analyse-Erweiterungen
Wenn Sie Analyse-Erweiterungen konfiguriert haben (früher als "externe Dienste" bezeichnet), müssen Sie Ihre Konfigurationsinformationen aufzeichnen. Durch ein Upgrade auf Tableau Server 2020.2 oder höher wird die gesamte Konfiguration für dieses Feature entfernt.
Führen Sie den folgenden Befehl aus, um die Konfiguration der Analyse-Erweiterungen aus den Tableau Server-Versionen 2019.1 bis 2020.1 abzurufen:
tsm security vizql-extsvc-ssl list
Führen Sie den folgenden tsm-Befehl aus, um das Kennwort abzurufen, das für die Verbindung mit Analyse-Erweiterungen gespeichert ist (falls vorhanden):
tsm configuration get -k vizqlserver.rserve.password
Sie sollten auch über eine Kopie des Zertifikats für Analyse-Erweiterungen verfügen, wenn Sie SSL konfiguriert haben.
Externes Repository
Das findet nur dann Anwendung, wenn Sie die externe Repository-Konfiguration mit Tableau Server verwenden. Wenn Sie nicht sicher sind, ob das auf Sie zutrifft, finden Sie weitere Informationen unter Externes Repository von Tableau Server.
Wenn Sie ein externes Repository verwenden, müssen Sie beim Durchführen des Upgrades möglicherweise zusätzliche Schritte ausführen.
- Keine Änderung bei der Versionsnummer – Wenn es keine Versionsänderung in PostgreSQL gibt, sind keine besonderen Maßnahmen erforderlich.
- Andere Nebenversionsnummer – Wenn sich bei der Nebenversion von PostgreSQL etwas ändert, müssen Sie bei Ihrem externen Repository ein Upgrade durchführen, bevor Sie Tableau Server aktualisieren. In den meisten Fällen gibt es dafür vor Ort festgelegte Methoden. Welche Methode Sie verwenden, hängt davon ab, an welcher Stelle Ihr Repository gespeichert wird, und geht über den Rahmen dieser Dokumentation hinaus.
Andere Hauptversionsnummer – Wenn sich bei der Hauptversionsnummer von PostgreSQL etwas ändert, müssen Sie die Schritte durchführen, die unter Aktualisieren von Tableau Server mit externem Repository für eine neue Hauptversion von PostgreSQL beschrieben sind.
Dazu gehört:
- Erstellen einer neuen Instanz der PostgreSQL-Datenbank Für weitere Informationen siehe:
- Erstellen Sie eine Konfigurationsdatei und laden Sie die SSL-Zertifikatsdatei für die neue Instanz herunter, die Sie in Schritt 1 erstellt haben.
Während des Upgrades müssen Sie Tableau Server mithilfe der Konfigurationsdatei auf die neue Instanz verweisen. Während des Upgrade-Vorgangs werden die Inhalte aus dem aktuellen externen Repository in die neue Instanz migriert. Weitere Informationen finden Sie unter Aktualisieren von Tableau Server mit externem Repository für eine neue Hauptversion von PostgreSQL.
Externer Dateispeicher
Beim Durchführen eines Upgrades für Tableau Server, das mit externem Dateispeicher konfiguriert ist, sind keine besonderen Schritte, Aktionen oder Konfigurationen erforderlich. Sie können Tableau Server nach der normalen Vorgehensweise aktualisieren.
Port-Anpassung
Wenn Sie den dynamischen Portbereich geändert oder Ports manuell für Tableau Server konfiguriert haben, zeichnen Sie die vorgenommenen Änderungen auf.
Führen Sie den folgenden Befehl aus:
tsm topology list-ports
Weitere Informationen finden Sie unter Tableau Services Manager-Ports.
Proxy-Anpassung
Wenn Sie OAuth verwenden und Änderungen an der Datei net.properties
für Tableau Server im Ordner <drive>:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\conf
vorgenommen haben, sollten Sie die vorgenommenen Änderungen protokollieren. Der Upgrade-Prozess erstellt eine neue Datei net.properties
und Sie müssen möglicherweise die neue nach dem Upgrade aktualisieren.
Sie können eine Kopie an einem sicheren Ort speichern und sie nach dem Upgrade verwenden, um sie mit der neu erstellten Datei auf Unterschiede zu vergleichen.
Weitere Informationen finden Sie unter Konfigurieren eines Forward-Proxys für OAuth-Authentifizierung(Link wird in neuem Fenster geöffnet) in der Hilfe zu Tableau Desktop und zur Webdokumenterstellung.