Hilfe zu Tableau Server für Linux

Das Upgrade-Protokoll app-install.log befindet sich unter /var/opt/tableau/tableau_server/logs.

Das Upgrade-Protokoll app-upgrade.log befindet sich unter /var/opt/tableau/tableau_server/logs.

Mehrere Installationsversuche schlagen fehl

Wenn Sie versuchen, Tableau Server zu installieren und die Installation fehlschlägt, schlagen anschließende Installationsversuche wahrscheinlich ebenfalls fehl, sofern Sie nicht das Skript tableau-server-obliterate ausführen, um Tableau vollständig vom Computer zu entfernen.

Durch einen fehlgeschlagenen Installationsversuch befindet sich der Computer möglicherweise in einem Zustand, in dem darauf folgende Versuche ebenfalls mit Fehlern fehlschlagen, die scheinbar nicht direkt mit einem vorherigen Installationsversuch in Zusammenhang stehen. Ein möglicher Fehler ist:

Enabling and starting all services
+ services=(appzookeeper* tabadmincontroller* tabsvc* licenseservice* fnplicenseservice* tabadminagent* clientfileservice*)
+ systemctl_user enable appzookeeper_0.service 'tabadmincontroller*' 'tabsvc*' 'licenseservice*' fnplicenseservice_0.service 'tabadminagent*' 'clientfileservice*'
++ id -ru a_tabadminpoc
+ local unprivileged_uid=222954
+ su -l a_tabadminpoc -c 'XDG_RUNTIME_DIR=/run/user/222954 systemctl --user enable appzookeeper_0.service tabadmincontroller* tabsvc* licenseservice* fnplicenseservice_0.service tabadminagent* clientfileservice*'
Failed to execute operation: No such file or directory

Führen Sie zur Behebung dieses Problems das Skript tableau-server-obliterate aus, um alle Überreste des vorherigen Installationsversuchs zu bereinigen, und starten den Computer neu. Weitere Informationen dazu finden Sie unter Ausführen des Skripts "tableau-server-obliterate".

Wichtig: Wenn Sie eine Sicherung von Tableau (<file>.tsbak) erstellt haben, die Sie beibehalten möchten (um sie beispielsweise in Ihrer neuen Installation wiederherzustellen), kopieren Sie diese Datei in ein sicheres Verzeichnis auf einem anderen Computer, um zu gewährleisten, dass sie beim Bereinigen Ihres Tableau-Computers nicht entfernt wird.

Fehlerhafte Installation aufgrund der Hardwareanforderungen

Tableau Server kann nicht installiert werden, wenn der Computer, auf dem Sie die Installation vornehmen, die Hardware-Mindestvoraussetzungen nicht erfüllt. Die Anforderungen gelten für alle Computer, auf denen Tableau Server installiert wird. Details über die Hardware-Mindestanforderungen finden Sie im Thema über die Hardware-Mindestanforderungen und -Mindestempfehlungen für Tableau Server.

Installation oder Upgrade schlägt aufgrund der CPU-Anforderungen fehl

Ab Version 2020.4 erfordert Tableau Server, dass alle Knoten über CPUs verfügen, die SSE4.2- und POPCNT-Befehlssätze unterstützen. Tableau Server 2020.4.0 oder höher kann auf Computern mit CPUs, die diese Anweisungssätze nicht unterstützen, nicht installiert oder aktualisiert werden.

Diese Fehlermeldung wird möglicherweise bei einer neuen Installation oder bei der Vorbereitung eines Upgrades für eine bestehende Installation angezeigt: 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

Die SSE4.2- und POPCNT-Befehlssätze sind seit mehr als 10 Jahren in Gebrauch und werden von den meisten neueren CPUs unterstützt. Wenn Sie jedoch beim Versuch, Tableau Server auf einer virtuellen Maschine (VM) zu installieren oder zu aktualisieren, eine Fehlermeldung in Bezug auf die Mindestanforderungen an den Prozessor erhalten, ist möglicherweise der Prozessorkompatibilitätsmodus auf der VM aktiviert. Um Tableau erfolgreich auf einer VM zu installieren oder zu aktualisieren, müssen Sie darauf achten, dass der Prozessorkompatibilitätsmodus deaktiviert ist.

Speicherort von Upgrade-Protokollen

Karten werden nach dem Upgrade gar nicht oder nicht vollständig angezeigt

Ab Tableau-Version 2019.2 wurden die Anforderungen für den Internetzugriff für Karten geändert. Wenn Sie ein Upgrade von Version 2019.1.x oder früher auf Version 2019.2.x oder höher ausführen und Karten nicht wie erwartet angezeigt werden, bestätigen Sie, dass Ihre Umgebung so konfiguriert ist, dass der Zugriff auf Port 443 auf mapsconfig.tableau.com und api.mapbox.com möglich ist.

In Version 2019.1.x oder früher war der Zugriff auf maps.tableausoftware.com erforderlich.

Weitere Einzelheiten zu den Anforderungen an den Internetzugriff finden Sie unter Kommunizieren mit dem Internet.

Upgrade-Skriptfehler: "Validierung der Tableau Server-Versionsänderung fehlgeschlagen."

Wenn Sie beim Upgrade das Skript upgrade-tsm aus dem scripts.<version_code>-Verzeichnis einer älteren Version verwenden, schlägt das Upgrade mit folgender Meldung fehl:

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

Wenn dieser Fehler auftritt, gehen Sie zum scripts.<version_code>-Verzeichnis für die Version, die Sie gerade installiert haben, und führen Sie das Skript von dort aus.

Beim Upgrade von mehreren Knoten schlägt das Initialisieren von Zusatzknoten mit dem Fehler "Geben Sie Ihre Anmeldeinformationen erneut ein" fehl

Wenn Sie bei einem Upgrade von Tableau Server versuchen, einen Zusatzknoten zu initialisieren und der Fehler

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

angezeigt wird, deutet dies darauf hin, dass der Knoten keine Verbindung zum Ausgangsknoten herstellen oder nicht mit ihm kommunizieren kann. Dies kann mehrere Ursachen haben:

• Die von Ihnen eingegebenen Anmeldeinformationen sind ungültig, oder Sie haben sie falsch eingegeben. Die Anmeldeinformationen müssen zu einem Benutzer mit Administratorberechtigungen auf dem Computer gehören, auf dem Tableau Server zuerst installiert war. Sie müssen zwar nicht die Anmeldeinformationen des Benutzers verwenden, der die Bootstrap-Datei erstellt hat, dadurch wird jedoch sichergestellt, dass Sie gültige Anmeldeinformationen verwenden.

• Die lokale Firewall des hinzuzufügenden Computers lässt keine Kommunikation mit dem Ausgangsknoten zu. Weitere Informationen finden Sie unter Lokale Firewall-Konfiguration.

Fehlerhafte Aktualisierung aufgrund von fehlendem Datenträgerspeicher

Wenn nicht genügend Datenträgerspeicherplatz für die Ausführung des Tableau Server-Einrichtungsprogramms und das Vornehmen der Aktualisierung zur Verfügung steht, treten bei der Installation Fehler auf. Der benötigte Datenträgerspeicher hängt von der Größe Ihrer Repositorydatenbank und der Anzahl und Größe Ihrer Extrakte ab.

So geben Sie Datenträgerspeicherplatz frei:

1. Erstellen Sie mithilfe des Befehls tsm maintenance ziplogs eine Protokollarchiv-Momentaufnahme.

   Nach dem Erstellen der Datei ziplogs, speichern Sie sie an einem sicheren Speicherort, der kein Bestandteil Ihrer Tableau Server-Installation ist.

2. Bereinigen Sie nicht mehr benötigte Dateien mit dem Befehl tsm maintenance cleanup. Weitere Informationen finden Sie unter Entfernen überflüssiger Dateien.

Upgrade schlägt beim RebuildSearchIndex-Auftrag fehl

Ab Version 2020.1.x besteht der letzte Schritt bei einem Upgrade darin, den Suchindex neu zu erstellen. Zu diesem Zeitpunkt wurden alle Dienste aktualisiert, sodass Sie, falls dieser Auftrag fehlschlägt, den Suchserver manuell zurücksetzen können, indem Sie den Befehl tsm maintenance reset-searchserver ausführen. Sie müssen nicht alles verwerfen und von vorne anfangen.

Der Fehler lautet wie folgt:

An error occurred while rebuilding search index.

So setzen Sie den Suchserver zurück:

1. Öffnen Sie auf dem ersten Knoten eine Terminal-Sitzung.

   Dies muss eine neue Terminal-Sitzung sein, da das Aktualisierungsskript die Systemumgebung für die neue Version aktualisiert.

2. Erstellen Sie den Suchindex mit dem Befehl tsm maintenance reset-searchserver neu.

Upgrade schlägt auf 2022.1 und höher fehl

Nach dem Upgrade von Tableau Server 2022.1 (oder höher) kann das Wiederherstellen einer Tableau Server-Sicherung als Teil Ihres Upgrade-Vorgangs den folgenden Fehler verursachen:

"Die Sicherung kann nicht wiederhergestellt werden, da Tableau Server standardmäßig die neuen Identitätsdiensttabellen verwendet."

Dieses Problem tritt auf, weil Tableau Server 2022.1 (und höher) ein Identitätsschema verwendet, das sich von dem von der Sicherung verwendeten Identitätsschema unterscheidet. Informationen zum Beheben dieses Problems finden Sie unter Fehlerbehebung bei Problemen mit der Identitätsmigration.

Upgrade schlägt in Version 2020.4.0 oder höher fehl

Ab Version 2020.4.0 können Sie mit der Checkpoint-Upgrade-Funktion ein fehlgeschlagenes Upgrade wiederholen. Im Allgemeinen ist dies besonders nützlich für erfahrene Serveradministratoren und IT-Experten, die mit Tableau Server-Protokolldateien vertraut und bereit sind, diese zu durchsuchen. Die Funktion kann jedoch bei allen fehlgeschlagenen Upgrades hilfreich sein, da Sie das Skript "upgrade-tsm" erneut ausführen können und das Skript ausgehend vom letzten erfolgreichen Schritt ausgeführt wird, was Zeit spart. Erfahrene Benutzer können möglicherweise Probleme wie Festplattenspeicherprobleme oder Berechtigungsprobleme identifizieren, beheben und das Upgrade erneut ausführen.

Wenn Sie ein Upgrade auf Version 2020.4.0 oder höher durchführen und das Upgrade fehlschlägt, können Ihnen die folgenden Schritte helfen, das Upgrade abzuschließen:

• Führen Sie das Skript upgrade-tsm erneut aus. Upgrade-Fehler sind mitunter das Ergebnis von Timeouts während des Aktualisierungsvorgangs, und durch das erneute Ausführen des Skripts können zeitweilige oder gelegentliche Zeitprobleme überwunden werden. Dieser Schritt ist zudem sicher und einfach. Das erneute Ausführen des Skripts schadet nicht, und im schlimmsten Fall schlägt das Upgrade an derselben Stelle erneut fehl, ohne jedoch die vorherigen Schritte durchlaufen zu müssen.

  Das Skript befindet sich im Verzeichnis \scripts:

  opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm

  Wenn Ihr Tableau Server-Upgrade beim erneuten Ausführen des Skripts "upgrade-tsm" nicht erfolgreich ist und Sie mit Tableau Server-Protokollen vertraut sind, können Sie die folgenden zusätzlichen Schritte zur Problembehandlung ausführen:

• Sehen Sie sich die Ausgabe des Skripts im Befehlsfenster an.. Nützliche Fehlermeldungen können Ihnen helfen, die Ursache des Upgrade-Fehlers zu identifizieren und Ihnen einige Ideen zur Behebung des Problems zu liefern.

• Untersuchen Sie die Datei app-upgrade.log. In der Befehlszeile angezeigte Fehler werden auch in der Datei app-upgrade.log angezeigt, oftmals mit mehr Details.

• Untersuchen Sie die Datei tabadmincontroller.log. Upgrade-Probleme, die in den beiden oben genannten Instanzen nicht leicht erkannt werden können, sind wahrscheinlich das Resultat eines Problems in einem Auftrag. Die Datei tabadmincontroller.log enthält möglicherweise weitere Informationen, die Ihnen bei der Diagnose des Problems helfen.

  Hinweis: Informationen zu Protokolldateispeicherorten finden Sie unter Speicherorte der Tableau Server-Protokolle und -Protokolldateien.

Upgrade schlägt aufgrund von Berechtigungsproblemen mit dem Speicherort der Sicherungs-/Wiederherstellungsdatei fehl

Bei Versionen von Tableau Server vor 2022.1.0 schlägt das Upgrade-Skript mit einer Fehlermeldung fehl, dass die Sicherungsdatei nicht gelesen oder das Repository nicht wiederhergestellt werden kann, wenn der Speicherort für die Sicherungs-/Wiederherstellungsdatei nicht über die richtigen Berechtigungen verfügt.

Ab Version 2022.1 bestätigt das Upgrade-Skript die Berechtigungen des Dateispeicherorts für die Sicherungs-/Wiederherstellungsdatei, bevor das Upgrade gestartet wird, damit die Datei während des Upgrades auf die neue Version von Tableau Server an diesem Speicherort geschrieben und gelesen werden kann.

Die Fehler werden ähnlich sein wie die folgenden:

The tableau user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

Der Speicherort, der von TSM für die Sicherung und Wiederherstellung verwendet wird, wird durch den Konfigurationsschlüssel basefilepath.backuprestore definiert und hat eine Voreinstellung, die das Installationsprogramm mit den korrekten Berechtigungen einrichtet, aber diese können durch IT-Regeln der Organisation beeinflusst werden oder wenn Sie den Speicherort in einen von Ihnen selbst erstellten ändern. Ein neuer Befehl, der ab 2022.1 verfügbar ist, ermöglicht es Ihnen, die Berechtigungen für den Speicherort der Sicherungs-/Wiederherstellungsdatei unmittelbar nach der Erstellung zu überprüfen, um Probleme mit den Berechtigungen zu vermeiden. Einzelheiten zu diesem Befehl finden Sie unter tsm maintenance validate-backup-basefilepath.

Einzelheiten über den Pfad der Sicherungs-/Wiederherstellungsdatei finden Sie unter tsm-Dateipfade.

Das Upgrade ist erfolgreich, aber auf veröffentlichte Datenquellen kann nicht zugegriffen werden

In wenigen, spezifischen Szenarien schlagen nach dem Upgrade von Tableau Server von Version 2021.3 auf frühe Versionen von 2023.1 oder 2023.3 Versuche fehl, eine Verbindung zu vorhandenen veröffentlichten Datenquellen herzustellen oder diese zu aktualisieren:

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

Dies könnte in folgenden Fällen passieren:

1. Sie aktualisieren eine Tableau Server-Installation der Version 2021.3.x zu einem beliebigen Zeitpunkt (Beispiel: Sie führen 2021.3 aus oder haben ein Upgrade von 2021.3 auf eine Version 2022.x durchgeführt).
   
   und

2. Sie führen ein Upgrade dieser Installation auf frühe Versionen von 2023.1 oder 2023.3 durch.

Keine Auswirkungen

In den folgenden Situationen treten keine Probleme auf:

• In allen anderen Upgradepfaden ab 2021.3

• In allen anderen Upgradepfaden bis 2023.1 oder 2023.3

• In allen neuen Installationen von 2023.1 und 2023.3

Weitere Informationen

Mit 16. September 2024 wurden alle problematischen Versionen aus dem Downloadbereich entfernt. Wenn Sie ein Upgrade auf Version 2023.1.x oder 2023.3.x vornehmen müssen, führen Sie ein Upgrade auf die Wartungsversionen 2023.1.16 oder höher bzw. 2023.3.9 oder höher durch.

Weitere Informationen über dieses Problem finden Sie unter Bekannte Probleme(Link wird in neuem Fenster geöffnet).

Allgemeine Probleme beim Importieren von Einstellungen

>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

Sicherstellen, dass Sie auf den Lizenzserver zugreifen können

Der Tableau-Lizenzierungsdienst wurde am 6. Oktober 2018 in ein neues Rechenzentrum verschoben. Das bedeutet, alle Umgebungen, für die für den Zugriff auf "licensing.tableau.com" eine spezielle Konfiguration erforderlich war (beispielsweise sichere Liste für statische IP-Adressen), oder licensing.tableau.com muss aktualisiert werden, bevor Sie einen Lizenzschlüssel für Tableau aktivieren, aktualisieren oder deaktivieren können.

Um den Zugriff zu testen, geben Sie die URL und den Port des Lizenzierungsservers in einen Browser ein:

https://licensing.tableau.com:443

und:

https://atr.licensing.tableau.com/_status/healthz

Wenn Sie auf den Server zugreifen können, wird für den ersten Server die Meldung "Testerfolg" und für den zweiten die Meldung "OK" angezeigt.

Tableau Server muss für Lizenzierungszwecke über eine Verbindung zu den folgenden Internetspeicherorten verfügen:

• atr.licensing.tableau.com:443

• licensing.tableau.com:443

• register.tableau.com:443

• o.ss2.us

• s.ss2.us

• crt.rootca1.amazontrust.com

• crt.sca1b.amazontrust.com

• crt.sca0a.amazontrust.com

• crt.sca1a.amazontrust.com

• crt.sca2a.amazontrust.com

• crt.sca3a.amazontrust.com

• crt.sca4a.amazontrust.com

• *.digicert.com

• ocsp.*.amazontrust.com

• crl.*.amazontrust.com

• crt.rootg2.amazontrust.com

Anfragen für die zuvor aufgeführten Domänen können an Port 80 oder 443 gerichtet werden. Port 80 wird für die Zertifikatvalidierung verwendet (Widerruf, Zertifikatskette usw.). Port 443 wird für SSL-Verbindungen verwendet.

An die Domänen ocsp.*.amazontrust.com und crl.*.amazontrust.com gerichtete Anfragen werden von Amazon auf Widerrufsinformationen des Zertifikats hin verwaltet. Weitere Informationen finden Sie unter Merkmale von ACM-Zertifikaten(Link wird in neuem Fenster geöffnet). Wir empfehlen, die Amazon-Stammzertifikate im Zertifikatsvertrauensspeicher auf dem Computer zu installieren, auf dem Tableau ausgeführt wird. Informationen zum Herunterladen und Installieren der Amazon-Stammzertifikate finden Sie unter Zertifizierungsstellen(Link wird in neuem Fenster geöffnet) auf der Amazon Trust Services-Website.

Überprüfen von Datum und Uhrzeit

Prüfen Sie, ob Datum und Uhrzeit auf dem Tableau Server-Ausgangscomputer korrekt eingestellt sind. Wenn Datum und Uhrzeit auf dem Computer vor dem aktuellen Datum liegen, kann Tableau Server nicht aktiviert werden.

Erzwingen des erneuten Lesens des Product Keys

1. Melden Sie sich am ursprünglichen Tableau Server-Computer als Benutzer mit Sudo-Zugriff an.

2. Navigieren Sie zum bin-Verzeichnis von Tableau Server. Standardmäßig lautet es:

   /opt/tableau/tableau_server/packages/bin.<version_code>/

3. Geben Sie die folgenden Befehle ein:

   tsm stop
   
   ./lmreread
   tsm start

Senden des Inhalts vertrauenswürdiger Speicher an den Tableau-Support

Wenn die FlexNet-Lizenzierungsdienste installiert wurden und ausgeführt werden, Sie jedoch weiterhin einen Fehler sehen, liegt möglicherweise ein Problem mit den Product Key-Informationen von Tableau vor. Befolgen Sie zum Beheben dieses Problems die folgenden Schritte, um eine Datei mit den Schlüsselinformationen zu erstellen, die sich in einem vertrauenswürdigen Speicher befindet.

1. Melden Sie sich am ursprünglichen Tableau Server-Computer als Benutzer mit Sudo-Zugriff an.

2. Geben Sie folgenden Befehl ein:

   serveractutil -view > <machine_name>-LicResults.txt

   Dadurch wird die Datei <machine_name>-LicResults.txt im aktuellen Verzeichnis erstellt. Wenn Sie nicht über Schreibberechtigungen für diesen Speicherort verfügen und eine Fehlermeldung angezeigt wird, wechseln Sie zu einem Speicherort, für den Sie die Berechtigung zum Erstellen einer Datei haben, und führen Sie den Befehl erneut aus.

3. Wenden Sie sich an den Kundensupport (http://www.tableau.com/de-de/support/request(Link wird in neuem Fenster geöffnet)) und geben Sie die Datei <machine_name>-LicResults.txt , die Sie erstellt haben, mit an.

Separates Installieren von tabcmd

tabcmd wird automatisch auf dem ursprünglichen Tableau Server-Knoten installiert, wenn Sie Tableau Server installieren. Wenn die Ausführung jedoch auf einem anderen Computer erfolgen soll, müssen Sie tabcmd separat herunterladen und installieren. Einzelheiten dazu finden Sie unter Installieren von "tabcmd".

Probleme beim Installieren von tabcmd unter Linux

tabcmd erfordert Java 11, um ordnungsgemäß ausgeführt zu werden. Auf RHEL-ähnlichen Systemen wird dies als Abhängigkeit installiert, wenn Sie tabcmd installieren. Auf Debian-ähnlichen Systemen müssen Sie Java 11 separat installieren, wenn es nicht bereits installiert ist.

Ab Juli 2022 werden Debian-Distributionen nicht mehr unterstützt. Weitere Informationen finden Sie in diesem Tableau Community-Beitrag(Link wird in neuem Fenster geöffnet).

Java ist nicht installiert

Wenn bei der Installation von tabcmd derartige Fehler auftreten, stellen Sie sicher, dass Java 11 auf Ihrem Linux-Computer installiert ist:

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

Falsche Version von Java ist installiert

Wenn derartige Fehler auftreten, stellen Sie sicher, dass Java 11 installiert ist:

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

oder

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.