tsm maintenance


Mit den tsm maintenance-Befehlen können Sie Serververwaltungsaufgaben ausführen, wie zum Beispiel Sicherungen durchführen oder Tableau Server aus einer zuvor erstellten Sicherung wiederherstellen.

tsm maintenance backup

Erstellt eine Sicherungsdatei der von Tableau Server verwalteten Daten. Zu diesen Daten gehört die Tableau PostgreSQL-Datenbank (das Repository), die Arbeitsmappen- und Benutzermetadaten sowie Extraktdateien (.hyper-Dateien, sowie .tde-Dateien für Versionen bis 2024.2) enthält. Diese Daten enthalten keine Konfigurationsdaten. Siehe Durchführen einer vollständigen Sicherung und Wiederherstellen von Tableau Server.

Hinweis:Verwenden Sie diesen Befehl nicht für Tableau Server-Installationen mit dem externen Dateispeicher. Siehe Sicherung und Wiederherstellung mit dem externen Dateispeicher.

Optimieren mit Topologiekonfigurationen:

  • Wenn sich der Dateispeicher und der Administration Controller auf demselben Knoten befinden, kann die Sicherung von Tableau Server unter Umständen schneller durchgeführt werden, da die Daten während des Sicherungsprozesses nicht mehr zwischen den Knoten übertragen werden müssen. Dies gilt insbesondere, wenn Ihre Organisation viele Extrakte verwendet.
  • Die Unterbringung des Repositorys (pgsql) auf dem Administration Controller-Knoten kann ebenfalls dazu beitragen, die Sicherung zu beschleunigen, die Zeitersparnis ist jedoch geringer als beim Dateispeicher.

Der Administration Controller befindet sich in der Regel auf dem ersten Knoten, es sei denn, es gab einen Fehler beim ersten Knoten und der Controller wurde auf einen anderen Knoten verschoben.

Die Sicherungsdatei wird an einem temporären Speicherort im Datenverzeichnis zusammengestellt und dann in das Verzeichnis geschrieben, das in der TSM-Variablen basefilepath.backuprestore definiert ist. Dies ist standardmäßig:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\<filename>.tsbak

Weitere Informationen darüber, wo Sicherungsdateien geschrieben werden und wie Sie den Speicherort ändern können, finden Sie unter tsm-Dateipfade. Hinweis: Selbst wenn Sie den Speicherort für die Sicherung ändern, verwendet der Sicherungsprozess einen temporären Speicherort im Datenverzeichnis, um die Sicherungsdatei zusammenzustellen.

Synopse

tsm maintenance backup --file <backup_file> [options] [global options]

Optionen

-f, --file <Sicherungsdatei>

Erforderlich.

Weitere Informationen zum Sichern der Repository-Daten finden Sie unter Sichern der Tableau Server-Daten.

-d, --append-date

Optional.

Hängt das aktuelle Datum an das Ende des Dateinamens der Sicherungsdatei an.

Hinweis: Sicherungen, die nach einem Zeitplan erstellt werden, enthalten automatisch ein Datum und eine Uhrzeit am Anfang des Dateinamens der Sicherung. Wenn Sie auch die Option -d verwenden, enthält der Dateiname das Datum zweimal. Weitere Informationen zum Planen von Sicherungen finden Sie unter Planen und Verwalten von Sicherungen.

-i, --description <Zeichenfolge>

Optional.

Schließt die angegebene Beschreibung der Sicherheitsdatei ein.

--ignore-prompt

Optional. Hinzugefügt in Version 2020.2.

Sichern ohne Aufforderung, auch wenn sich der Dateispeicher nicht auf demselben Knoten wie der Administrationscontroller (in der Regel der Anfangsknoten) befindet. Verwenden Sie diese Eingabeaufforderung, wenn Sie Sicherungen automatisieren (z. B. mit Skripts).

-k, --skip-verification

Optional.

Die Integrität der Datenbanksicherung wird nicht überprüft.

--multithreaded

Optional. Hinzugefügt in Version 2021.1.

Standardmäßig wird beim Erstellen einer Tableau Server-Sicherung ein einzelner Thread verwendet. Wenn diese Option ausgewählt ist, wird eine Sicherung mit mehreren Threads erstellt. Bei Auswahl dieser Option werden standardmäßig zwei Threads verwendet. Sie können die Anzahl der verwendeten Threads ändern, indem Sie den backup.zstd.thread_count-Konfigurationsschlüssel festlegen.

--override-disk-space-check

Optional.

Versuchen Sie, eine Sicherung zu erstellen, selbst wenn eine Warnung in Bezug auf geringen Datenträgerspeicher angezeigt wird.

-po, --pg-only

Optional.

Generiert nur die Sicherung des Repositorys.

Wichtig: Verwenden Sie beim Erstellen einer Sicherung nicht die Option pg-only, es sei denn, Sie werden vom Tableau-Support dazu aufgefordert. Mit dieser Option wird nur das Repository gesichert, zur Wiederherstellung Ihres Servers kann sie nicht verwendet werden. Sie wird hauptsächlich für Fehlerbehebungszwecke verwendet. Der Tableau-Support wird Sie auffordern, eine --pg-only-Sicherung zu erstellen, falls erforderlich.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Anzahl an Sekunden, die gewartet werden soll, bis der Befehl beendet ist. Der Standardwert beträgt 86.400 (1.440 Minuten).

-sd, --schedule-days <day[,day]>

Optional. Hinzugefügt in Version 2020.4.

Tage, an denen der Zeitplan ausgeführt werden soll. Verwenden Sie 1-7 für wöchentliche Zeitpläne (1 für Montag, 7 für Sonntag), 1-31 für monatliche Zeitpläne (wenn ein Monat den angegebenen Tag nicht enthält, wird der letzte Tag des Monats verwendet). Trennen Sie mehrere Werte durch Kommas voneinander ab.

-si, --schedule-id <ID>

Optional. Hinzugefügt in Version 2020.4.

Geben Sie die ID eines vorhandenen Zeitplans an, den Sie aktualisieren möchten.

--skip-compression

Optional.

Erstellt eine unkomprimierte Sicherung. Die Sicherungsdatei wird dadurch größer, jedoch verkürzt sich vermutlich die Zeit für die Erstellung der Sicherung. Wenn Sie diesen Parameter in einer Installation mit mehreren Knoten verwenden, sollte auf dem Ausgangsknoten eine Dateispeicherinstanz konfiguriert sein.

-sn, --schedule-name <name>

Optional. Hinzugefügt in Version 2020.4.

Geben Sie den Namen für einen Zeitplan an, den Sie erstellen oder aktualisieren.

-sr, --schedule-recurrence <frequency>

Optional. Hinzugefügt in Version 2020.4.

Häufigkeit der Zeitplanwiederholung. Gültige Optionen sind "täglich", "wöchentlich" oder "monatlich".

-st, --schedule-time <HH:MM>

Optional. Hinzugefügt in Version 2020.4.

Die Zeit, zu der ein Zeitplan ausgeführt werden soll, im 24-Stunden-Format: HH:MM.

Beispiele

In diesem Beispiel wird eine Sicherung mit dem Namen ts_backup-<yyyy-mm-dd>.tsbak im Ordner C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\ erstellt:

tsm maintenance backup -f ts_backup -d

In diesem Beispiel wird ein wiederkehrender wöchentlicher Sicherungsplan mit dem Namen "weekly-saturday-backup" erstellt, der jeden Samstag um 12 Uhr ausgeführt, wird und eine Sicherung mit dem Namen <yyyy.mm.dd.hh.mm>-ts_saturday_backup.tsbak:

tsm maintenance backup -f ts_saturday_backup -sr weekly -st 12:00 -sd 6 -sn weekly-saturday-backup

Weitere Informationen zum Verwalten geplanter Sicherungen finden Sie unter Planen und Verwalten von Sicherungen.

tsm maintenance cleanup

In der Standardeinstellung löscht der Befehl tsm maintenance cleanup temporäre Dateien und Protokolldateien, die älter als einen Tag sind. Die Länge der Aufbewahrungsfrist und welche Dateien gelöscht werden sollen, kann mithilfe von Befehlsoptionen geändert werden.

Die Auswirkungen dieses Befehls hängen davon ab, ob Tableau Server ausgeführt wird.

  • Wenn der Server ausgeführt wird, können die meisten alten Dateien und http_requests-Tabelleneinträge gelöscht werden, während gerade in Verwendung befindliche Dateien (die vom Betriebssystem gesperrt sind), nicht gelöscht werden können, weshalb temporäre Dateien und aktive Protokolldateien nicht entfernt werden. Wenn temporäre Dateien und aktuelle Protokolldateien zu entfernen, müssen Sie den Server anhalten, bevor Sie diesen Befehl ausführen. Verwenden Sie zum Löschen von http_requests-Tabelleneinträgen die Option -q.
  • Wenn der Server gestoppt ist, können http_requests-Einträge nicht gelöscht werden.

Wenn Sie Tableau Server in einer verteilten Umgebung ausführen, führen Sie diesen Befehl auf dem Knoten aus, auf dem der Verwaltungs-Controller-Prozess (der auch als TSM-Verwaltungs-Controller bezeichnet wird) ausgeführt wird. In der Standardeinstellung und in den meisten Fällen befindet sich der Controller auf dem Primärknoten im Cluster.

Synopse

tsm maintenance cleanup [options] [global options]

Optionen

-a, --all

Optional.

Führen Sie alle Bereinigungsvorgänge mit den Standardwerten für die Aufbewahrung durch. Äquivalent zur Ausführung des Befehls cleanup mit den folgenden Optionen: -l -t -r -q -ic.

--http-requests-table-retention <Anzahl Tage>

Optional.

Standardwert: 7 Tage

Geben Sie die Anzahl der Tage der http_requests-Tabelleneinträge an, die gespeichert werden sollen. Verwenden Sie diese Option mit der Option -q, um die Anzahl der Tage anzugeben, die Tabelleneinträge aufbewahrt werden sollen (wodurch der Standardwert von 7 Tagen außer Kraft gesetzt wird). Diese Option gibt die Speicherdauer von Tabelleneinträgen an, sie löst jedoch nicht die tatsächliche Löschung von Tabelleneinträgen aus. Verwenden Sie diese Option zusammen mit der Option -q, die das Löschen von Einträgen auslöst.

-ic, --sheet-image-cache

Optional. Hinzugefügt in Version 2019.4.

Leeren Sie den Bilder-Zwischenspeicher. Dieser Cache kann Bilder für Offlinevorschauen, Snapshots für Abonnement-E-Mail-Nachrichten und Abonnement-PDFs sowie beliebige Bilder enthalten, die vom REST API-Endpunkt der Veröffentlichung angefordert werden (siehe unter rest_api_ref.htm(Link wird in neuem Fenster geöffnet) für weitere Informationen).

-l, --log-files

Optional.

Löscht Protokolldateien, die älter als die 1 Tag sind. Dateien in den Unterverzeichnissen unter data\tabsvc\logs werden gelöscht.

--log-files-retention <Anzahl der Tage>

Optional.

Standard: 1 (24 Stunden)

Damit werden Protokolle gelöscht, die älter als die angegebene Anzahl an Tagen sind. Verwenden Sie diese Option, um die standardmäßige Aufbewahrungsfrist von 1 Tag zu überschreiben. Dieser Befehl kann nicht für temporäre Dateien verwendet werden.

-q, --http-requests-table

Optional.

Löschen Sie alte http_requests-Tabelleneinträge. Tableau Server muss ausgeführt werden, damit Tabelleneinträge gelöscht werden können. Diese Option wird ignoriert, wenn Tableau Server beendet wird. Diese Option kann allein verwendet werden, um das Löschen von Einträgen anzugeben, die älter als der standardmäßige Aufbewahrungszeitraum (7 Tage) sind. Alternativ kann sie mit --http-requests-table-retention verwendet werden, um einen nicht standardmäßigen Aufbewahrungszeitraum anzugeben.

Hinweis: Beim Löschen von http_requests-Tabelleneinträgen werden Daten dauerhaft entfernt, die für benutzerdefinierte Verwaltungsansichten verfügbar sind. Stellen Sie sicher, dass das Entfernen dieser Daten keine Auswirkungen auf benutzerdefinierte Ansichten hat, die Sie benötigen.

-r, --redis-cache

Optional.

Leeren Sie den Redis-Zwischenspeicher.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Standard: 3600

Wartezeit, bis der Befehl abgeschlossen ist.

-t, --temp-files

Optional.

Löschen alle Dateien und Unterverzeichnisse in folgenden Verzeichnissen:

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\temp: Um Dateien in jedem Tableau Server-Prozessverzeichnis zu löschen, müssen Sie Tableau Server stoppen, bevor Sie den Befehl ausführen. Wenn Sie den Befehl ausführen, während Tableau Server ausgeführt wird, werden nur Verzeichnisse gelöscht, in denen Dateien für abgelaufene (nicht laufende) Sitzungen gespeichert sind.

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\httpd\temp

  • <install dir>\ProgramData\Tableau\Tableau Server\temp

Beispiele

Beispiel zum Bereinigen sämtlicher Protokolldateien, die älter als zwei Tage sind:

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance jmx disable

Version: Der Befehl wurde in Version 2022.1 hinzugefügt.

Deaktivieren Sie mithilfe des Befehls tsm maintenance jmx disable JMX auf Tableau Server.

Das Ausführen dieses Befehls erfordert einen Neustart von Tableau Server, einschließlich TSM-Dienste.

Synopse

tsm maintenance jmx disable [options] [global options]

Optionen

--ignore-prompt

Optional.

Deaktivieren Sie JMX ohne Aufforderung.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance jmx enable

Version: Der Befehl wurde in Version 2022.1 hinzugefügt.

Aktivieren Sie mithilfe des Befehls tsm maintenance jmx enable JMX auf Tableau Server.

Dieser Befehl ist interaktiv, d. h., Sie werden aufgefordert, die entsprechenden Optionen einzugeben, wenn Sie diese nicht als Befehlszeilenparameter angeben.

Dieser Befehl erfordert einen Neustart von Tableau Server, einschließlich TSM-Dienste.

Synopse

tsm maintenance jmx enable

Optionen

--access <readonly | readwrite>

Optional.

Aktivieren Sie JMX entweder nur mit Lese- oder mit Lese- und Schreibzugriff. Der Standardwert lautet readonly.

--ignore-prompt

Optional.

Aktivieren Sie JMX ohne Aufforderung zur Eingabe zusätzlicher Sicherheitsoptionen. Dies aktiviert JMX mit SSL und startet Tableau Server neu, wenn Sie keine anderen Befehlsoptionen angeben. Beispiel:

tsm maintenance jmx enable --ignore-prompt

--no-ssl

Optional.

Aktivieren Sie JMX ohne SSL.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

--ssl-client-auth

Optional.

Aktivieren Sie JMX mit erforderlicher Client-Authentifizierung für SSL.

--unsecured

Optional.

Aktivieren Sie JMX, ohne die Sicherheitsfunktionen zu aktivieren (nicht empfohlen). Dies entspricht der Einstellung des Konfigurationsschlüssels service.jmx_enabled auf true in Versionen vor 2022.1.

tsm Wartung Metadaten-Dienste deaktivieren

Version: Der Befehl wurde in Version 2019.3 hinzugefügt.

Verwenden Sie den Befehl tsm maintenance metadata-services disable, um die Tableau Metadaten-API zu deaktivieren.

Durch das Deaktivieren der Metadaten-API wird die fortlaufende Aufnahme und Indizierung von Informationen über den Inhalt auf Tableau Server gestoppt, der Index der Informationen über den auf Tableau Server veröffentlichten Inhalt und die mit diesem Inhalt verbundenen Assets gelöscht. Dabei wird auch die Möglichkeit deaktiviert, sowohl die Metadaten-API abzufragen als auch auf Tableau Catalog zuzugreifen.

Die Ausführung dieses Befehls stoppt und startet einige von Tableau Serverden Benutzern verwendete Dienste, wodurch bestimmte Funktionen, wie z.B. Empfehlungen, für Ihre Benutzer vorübergehend nicht verfügbar sind.

Synopse

tsm maintenance metadata-services disable

Option

--ignore-prompt

Optional.

Verwerfen Sie die Sicherheitsabfrage beim Deaktivieren der Metadaten-API.

tsm maintenance metadata-services enable

Version: Der Befehl wurde in Version 2019.3 hinzugefügt.

Verwenden Sie den Befehl tsm maintenance metadata-services enable, um die Tableau Metadaten-API für Tableau Server zu aktivieren.

Wenn Tableau Server mit Tableau Data Management lizenziert ist, wird Tableau Catalog durch Aktivieren der Metadaten-API aktiviert.

Beim Aktivieren der Metadaten-API werden Informationen zum Inhalt von Tableau Server erfasst und dann im Metadaten-API-Speicher indiziert. Mit der Metadaten-API können Schema-, Herkunfts- und benutzerverwaltete Metadaten zu den unter Tableau Server veröffentlichten Inhalten abgefragt werden. Nach der Aktivierung der Metadaten-API werden die Metadaten kontinuierlich aufgenommen und indiziert, bis die Metadaten-API deaktiviert wird.

Wenn Sie diesen Befehl ausführen, beachten Sie bitte Folgendes:

  • Dieser Befehl stoppt und startet einige von Tableau Server verwendete Dienste, wodurch bestimmte Funktionen, wie z.B. Empfehlungen, für Ihre Benutzer vorübergehend nicht verfügbar sind.
  • Ein neuer Index der Metadaten wird erstellt und ersetzt bei jeder Verwendung dieses Befehls den vorherigen Index.

´Für weitere Informationen zuTableau Catalog, siehe Über Tableau Catalog.

Synopse

tsm maintenance metadata-services enable

Option

--ignore-prompt

Optional.

Verwerfen Sie die Sicherheitsabfrage bei der Aktivierung der Metadaten-API.

tsm maintenance metadata-services get-status

Version: Der Befehl wurde in Version 2019.3 hinzugefügt.

Verwenden Sie den Befehl tsm maintenance metadata-services get-status, um Statusinformationen über Metadata Services zu erhalten.

Der Status von "Metadata Services" gibt an, ob der Metadaten-API-Store initialisiert wurde oder ob die Tableau Metadaten-API ausgeführt wird oder nicht.

Synopse

tsm maintenance metadata-services get-status

tsm maintenance preflight-check permissions

Version: Der Befehl wurde für Tableau Server unter Windows in Version 2020.3 hinzugefügt.

Verwenden Sie den Befehl tsm maintenance preflight-check permissions, um die Verzeichnisberechtigungen zu überprüfen.

Synopse

tsm maintenance preflight-check permissions [options] [global options]

Option

-d, --data-dir <Datenverzeichnis>

Optional.

Gibt das Datenverzeichnis an, für das Berechtigungen überprüft werden sollen. Wenn das Datenverzeichnis nicht enthalten ist, wird es basierend auf der aktuellen Tableau Server-Konfiguration ermittelt.

-i, --install-dir <Installationsverzeichnis>

Optional.

Gibt das Installationsverzeichnis an, für das Berechtigungen überprüft werden sollen. Wenn das Installationsverzeichnis nicht enthalten ist, wird es basierend auf der aktuellen Tableau Server-Konfiguration ermittelt.

-n, --nodes <nodeID,nodeID,...>

Optional.

Knoten-IDs von Knoten, die speziell in die Berechtigungsprüfung eingeschlossen werden sollen. Bei fehlender Angabe wird die Prüfung auf allen Knoten im Cluster durchgeführt.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

-ru --runas-user <Zeitüberschreitung in Sekunden>

Optional.

Der Benutzername für "Als Benutzer ausführen", für den Berechtigungen überprüft werden sollen. Bei fehlender Angabe wird der Benutzer für "Als Benutzer ausführen" aus der aktuellen Konfiguration ermittelt.

tsm maintenance preflight-check ports

Version: Der Befehl wurde für Tableau Server unter Windows in Version 2020.3 hinzugefügt.

Verwenden Sie den Befehl tsm maintenance preflight-check ports, um sicherzustellen, dass Ports für alle derzeit installierten Dienste verfügbar sind. Geben Sie einen Dienst und Port an, um sicherzustellen, dass der Port für diesen Dienst verfügbar ist, auch wenn der Dienst derzeit nicht installiert ist.

Synopse

tsm maintenance preflight-check ports [options] [global options]

Option

-a, --tabadminagent-addresses <hostname:port>

Optional.

Gibt den Host und den Port an, auf dem der Zugriff auf den Verwaltungsagent überprüft werden soll. Adressen werden nach dem Schema hostname:port formatiert. Wenn mehrere Adressen überprüft werden, trennen Sie sie durch Kommas. Verwenden Sie diese Option, um vor dem Installieren oder Ändern von Ports zu überprüfen, ob ein Port verfügbar ist.

-g, --gateway-addresses <hostname:port>

Optional.

Gibt den Host und den Port an, auf dem der Zugriff auf den Gateway-Dienst überprüft werden soll. Adressen werden nach dem Schema hostname:port formatiert. Wenn mehrere Adressen überprüft werden, trennen Sie sie durch Kommas. Verwenden Sie diese Option, um vor dem Installieren oder Ändern von Ports zu überprüfen, ob ein Port verfügbar ist.

-n, --nodes <nodeID,nodeID,...>

Optional.

Knoten-IDs von Knoten, für die Preflight-Überprüfung ausgeführt werden soll. Bei fehlender Angabe werden die Überprüfungen auf allen Knoten im Cluster durchgeführt.

-r, --repository-addresses <hostname:port>

Optional.

Gibt den Host und den Port an, auf dem der Zugriff auf den Repository-Dienst überprüft werden soll. Adressen werden nach dem Schema hostname:port formatiert. Wenn mehrere Adressen überprüft werden, trennen Sie sie durch Kommas. Verwenden Sie diese Option, um vor dem Installieren oder Ändern von Ports zu überprüfen, ob ein Port verfügbar ist.

-re --remote

Optional.

Überprüft den Remotezugriff auf den Verwaltungsagent von allen Knoten aus. Dies erfolgt nicht standardmäßig.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

-t, --tabadmincontroller-addresses <hostname:port>

Optional.

Gibt den Host und den Port an, auf dem der Zugriff auf den Administrationscontroller überprüft werden soll. Adressen werden nach dem Schema hostname:port formatiert. Wenn mehrere Adressen überprüft werden, trennen Sie sie durch Kommas. Verwenden Sie diese Option, um vor dem Installieren oder Ändern von Ports zu überprüfen, ob ein Port verfügbar ist.

tsm maintenance reindex-search

Verwenden Sie den Befehl tsm maintenance reindex-search, um den Suchindex neu zu erstellen.

Synopse

tsm maintenance reindex-search [options] [global options]

Option

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance reset-searchserver

Ausführung: Dieser Befehl wurde in 2023.3.0 eingestellt (entfernt), als "Suchen und Durchsuchen" (auch Search Server genannt) eingestellt wurde. Suchen und Durchsuchen wurde durch Indizierungs- und Suchserver ersetzt.

Notiz: Das Ausführen dieses Befehls auf Version 2023.3.0 oder höher hat keine Auswirkung.

Setzt den Suchserver in einen bereinigten Zustand zurück, löscht Suchinformationen und erstellt den Suchindex neu.

Synopse

tsm maintenance reset-searchserver [options] [global options]

Option

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance restore

Stellt Tableau Server mithilfe der angegebenen Sicherungsdatei wieder her. Beim Wiederherstellen einer Sicherungsdatei werden keine Konfigurationsdaten wiederhergestellt. Siehe Durchführen einer vollständigen Sicherung und Wiederherstellen von Tableau Server.

Sie können eine Wiederherstellung nur über eine Sicherung vornehmen, die denselben Identitätsspeichertyp wie der aktive Benutzer aufweist. Beispielsweise kann eine Sicherung über einen Server mittels lokaler Authentifizierung in einer Tableau Server-Instanz wiederhergestellt werden, die mit lokaler Authentifizierung initiiert wurde. Eine Sicherung über einen Server unter Verwendung der Active Directory-Authentifizierung kann jedoch nicht auf einem Server wiederhergestellt werden, der mit lokaler Authentifizierung initialisiert wurde.

Ab Version 2022.3 werden mit tabadmin erstellte Sicherungen ("Vor-TSM-Sicherungen") nicht mehr unterstützt. Sie können eine Vor-TSM-Sicherung nicht auf Tableau Server, Version 2022.3 oder höher, wiederherstellen.

Synopse

tsm maintenance restore --file <file_name> [--restart-server] [global options]

Optionen

-f, --file <Dateiname>

Erforderlich.

Gibt die Sicherungsdatei für die Wiederherstellung an.

Der Befehl restore erwartet, dass sich eine Sicherungsdatei in dem Verzeichnis befindet, das in der TSM-Variablen basefilepath.backuprestore definiert wurde. Standardmäßig:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

Weitere Informationen zu Dateipfaden und wie Sie diese ändern können, finden Sie unter tsm-Dateipfade.

-ak, --asset-key-file <Dateiname>

Optional. Eingestellt in Version 2021.4.0.

Geben Sie diese Option nur an, wenn Sie Daten aus Assets wiederherstellen, die von Tabadmin auf Tableau Server erstellt wurden (Versionen 2018.1 und früher).

Name der Asset-Schlüsseldatei, aus der wiederhergestellt werden soll. Die Asset-Schlüsseldatei wird durch den tabadmin assetkeys-Befehl erstellt. Die Datei muss sich am vordefinierten Speicherort für Sicherung / Wiederherstellung auf dem Server befinden.

-k, --skip-identity-store-verification

Optional. Geben Sie diese Option nur an, wenn Sie Daten aus einer Sicherungsdatei wiederherstellen, die von Tabadmin auf Tableau Server erstellt wurde (Versionen 2018.1 und früher).

Verwenden Sie diesen Schlüssel nicht, um den Identitätsspeichertyp in Tableau Server ändern, der die ursprüngliche Sicherungsdatei erstellt hat. Informationen zum Ändern des Identitätsspeichers finden Sie unter Ändern des Identitätsspeichers.

-po, --pg-only

Optional.

Stellt nur das Repository wieder her.

-r, --restart-server

Optional.

Startet den Server nach der Wiederherstellung neu.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance send-logs

Laden Sie die angegebene Datei zu Tableau hoch, und weisen Sie ihr einen Support-Vorgang zu. Um Dateien erfolgreich in Tableau hochladen zu können, muss Ihr Tableau Server mit dem Sendeprotokollserver unter https://report-issue.tableau.com kommunizieren können.

Synopse

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

Optionen

-c,--case <Vorgangsnummer>

Erforderlich.

Support-Vorgang.

-e,--email <Kontakt-E-Mail>

Erforderlich.

E-Mail-Adresse für die Kontaktaufnahme.

-f, --file <path/to/file>

Erforderlich.

Gibt den Speicherort und den Namen des zu sendenden Protokolldatei-Archivs an.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance snapshot-backup complete

Version: Der Befehl wurde in Version 2020.1 hinzugefügt und ist nur verfügbar, wenn Tableau Server für den externen Dateispeicher konfiguriert ist.

Schließen Sie den Snapshot-Sicherungsprozess auf Tableau Server ab. Führen Sie dies aus, nachdem Sie eine Snapshot-Sicherung Ihres externen Speichers erstellt haben.

Die Befehle ttsm maintenance snapshot-backup prepare und tsm maintenace snapshot-backupcomplete werden verwendet, um eine Sicherung von Tableau Server-Daten für Tableau Server-Installationen zu erstellen, die mit dem externen Dateispeicher konfiguriert sind. Weitere Informationen finden Sie unter Sicherung und Wiederherstellung mit dem externen Dateispeicher.

Synopse

tsm maintenance snapshot-backup complete [options] [global options]

Optionen

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance snapshot-backup prepare

Version: Der Befehl wurde in Version 2020.1 hinzugefügt und ist nur verfügbar, wenn Tableau Server für den externen Dateispeicher konfiguriert ist.

Es erfolgt die Vorbereitung der Snapshot-Sicherung. Sobald der Vorbereitungsschritt abgeschlossen ist, können Sie eine Snapshot-Sicherung Ihres Netzwerkspeichers erstellen.

Die Befehl tsm maintenance snapshot-backup prepare und tsm maintenace snapshot-backup complete werden verwendet, um eine Sicherung von Tableau Server-Daten für Tableau Server-Installationen zu erstellen, die mit externem Dateispeicher konfiguriert sind. Weitere Informationen finden Sie unter Sicherung und Wiederherstellung mit dem externen Dateispeicher.

Synopse

tsm maintenance snapshot-backup prepare [options] [global options]

Optionen

--include-pg-backup

Optional. Hinzugefügt in Version 2021.1. In früheren Versionen war immer eine Sicherung des externen Repositorys enthalten.

Optional.

Eine Sicherung des Repositorys wird erstellt und in die Netzwerkfreigabe kopiert. Dies gilt nur für Bereitstellungen, bei denen sowohl externes Repository als auch externer Dateispeicher konfiguriert sind. Weitere Informationen finden Sie unter Sicherung und Wiederherstellung mit dem externen Dateispeicher.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance snapshot-backup restore

Version: Der Befehl wurde in Version 2020.1 hinzugefügt und ist nur verfügbar, wenn Tableau Server für den externen Dateispeicher konfiguriert ist.

Stellt die Repository-Sicherung aus dem Speicher-Snapshot in Tableau Server wieder her.

Weitere Informationen finden Sie unter Sicherung und Wiederherstellung mit dem externen Dateispeicher.

Synopse

tsm maintenance snapshot-backup restore [options] [global options]

Optionen

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance validate-backup-basefilepath

Version: Der Befehl wurde in Version 2022.1 hinzugefügt.

Überprüfen Sie, ob der Speicherort des Basisdateipfads für die Sicherung/Wiederherstellung über die richtigen Berechtigungen verfügt, damit die Sicherungs- und Wiederherstellungsfunktionen ordnungsgemäß funktionieren. Führen Sie dies aus, nachdem Sie den Basisdateipfad für die Sicherung und Wiederherstellung festgelegt haben. Weitere Informationen finden Sie unter Ändern des aktuellen Dateispeicherorts.

Synopse

tsm maintenance validate-backup-basefilepath [options][global options]

Optionen

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance validate-resources

Validieren Sie Arbeitsmappen und Datenquellen für eine Site. Verwenden Sie diesen Befehl, bevor Sie eine Site migrieren, um Probleme mit Website-Ressourcen wie Arbeitsmappen und Datenquellen zu erkennen, die zu einem Problem mit dem Standortimports führen können. Einige Ressourcenprobleme können durch erneutes Veröffentlichen aus lokalen Quellen behoben werden. Andere Probleme erfordern möglicherweise die Unterstützung vom Tableau-Support.

Synopse

tsm maintenance validate-resources --site-id <site ID> [global options]

Optionen

-id,--site-id <site ID>

Erforderlich.

ID für die Site, deren Ressourcen Sie validieren.

-r,--repair

Optional.

Versuchen Sie, ungültige Ressourcen zu reparieren. Diejenigen, die nicht repariert werden können, werden in der Ausgabe vermerkt.

--request-timeout <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist.

tsm maintenance ziplogs

Verwenden Sie den Befehl ziplogs , um ein Archiv mit Tableau Server-Protokolldateien zu erstellen.

Synopse

tsm maintenance ziplogs [options] [global options]

Optionen

-a, --all

Optional.

Enthält msinfo, netstat und das neueste Abbild. Äquivalent der Ausführung des Befehls mit diesen Optionen: -mi -t -l. Enthält keine PostgreSQL-Daten.

-d, --with-postgresql-data

Optional.

Der PostgreSQL-Datenordner wird eingeschlossen, wenn Tableau Server angehalten wurde. PostgreSQL-Speicherauszugsdateien werden eingeschlossen, wenn Tableau Server ausgeführt wird. Dieses Flag wird bei Bereitstellungen mit einem Externes Repository von Tableau Server ignoriert.

--enddate "<mm/dd/yyyy H:mm>"

Optional. Zeitoption (H:mm ) in Version 2021.4.0 hinzugefügt.

Das finale Datum der Protokolldateien, die eingeschlossen werden sollen. Diese Optionen müssen mit --startdate verwendet werden und können nicht mit --minimumdate verwendet werden. Wenn diese Option nicht angegeben wird, werden Protokolle für bis zu zwei Tage gespeichert, beginnend um 00:00 Uhr GMT.

Wenn Sie die Zeitoption einbeziehen, müssen Sie Datum und Uhrzeit in Anführungszeichen setzen. Die Zeitoption verwendet GMT, die resultierenden Protokolldateien werden jedoch unter Verwendung der lokalen Zeitzone des Tableau Server-Computers geschrieben.

Beispiel: Wenn die lokale Zeitzone des Tableau Server-Computers PDT ist und Sie möchten, dass die Protokolldateien am 28.07.2022 um 7:00 Uhr PDT beginnen und um 19:00 Uhr PDT enden, verwenden Sie den folgenden Befehl:

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

-f, --file <Name>

Optional.

Geben Sie einen Namen für die komprimierte Archivdatei an. Wenn kein Name angegeben wird, wird das erstellte Archiv logs.zip benannt. Die Datei wird in das Verzeichnis geschrieben, das in der TSM-Variablen basefilepath.log_archive definiert wurde. Standardmäßig:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

Weitere Informationen zu Dateipfaden und wie Sie diese ändern können, finden Sie unter tsm-Dateipfade.

-i, --description <Zeichenfolge>

Optional.

Schließt die angegebene Beschreibung der Archivdatei ein.

-l, --with-latest-dump

Optional.

Wenn ein Dienst abstürzt, generiert Tableau Server ein Dumpfile. Aktivieren Sie diese Option, um das neueste Dienstabsturz-Dumpfile einzuschließen. Wenn Sie diese Option nicht aktivieren, wird kein Dumpfile in das resultierende Ziplog aufgenommen.

-m, --minimumdate <mm/dd/yyyy>

Optional.

Das früheste Datum der Protokolldateien, die eingeschlossen werden sollen. Wenn nicht angegeben, werden maximal Protokolldateien der letzten zwei Tage eingeschlossen. Folgendes Datenformat muss verwendet werden: "mm/dd/yyyy". Diese Option kann nicht mit --startdate und --enddate oder --all verwendet werden.

-mi, --with-msinfo

Optional.

Fügt den Bericht "msinfo32" mit Systeminformationen zum Betriebssystem, zur Hardware und zu installierter Software ein.

--nodes

Optional. Hinzugefügt in Version 2020.3.

Geben Sie die Knoten an, für die eine Ziplog-Datei erstellt werden soll. Wenn nicht angegeben, werden Ziplog-Dateien für alle Knoten erstellt und auf dem Anfangsknoten gespeichert. Trennen Sie Knoten mit einem Komma. So erfassen Sie z. B. Protokolle für die Knoten 2 und 4:

tsm maintenance ziplogs --nodes node2,node4

-o, --overwrite

Optional.

Zum Überschreiben einer vorhandenen Ziplog-Datei. Wenn bereits eine Datei mit dem gleichen Namen vorhanden ist und diese Option nicht verwendet wird, schlägt der Ziplogs-Befehl fehl.

Die Datei wird standardmäßig in folgendes Verzeichnis geschrieben:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

Weitere Informationen zu Dateipfaden und wie Sie diese ändern können, finden Sie unter tsm-Dateipfade.

--request-timeout <seconds>

Optional.

Anzahl an Sekunden, die gewartet werden soll, bis der Befehl beendet ist. Der Standardwert beträgt 7.200 (120 Minuten).

--startdate "<mm/dd/yyyy H:mm>"

Optional. Zeitoption (H:mm ) in Version 2021.4.0 hinzugefügt.

Das finale Datum der Protokolldateien, die eingeschlossen werden sollen. Diese Optionen müssen mit --enddate verwendet werden und können nicht mit --minimumdate verwendet werden. Wenn diese Option nicht angegeben wird, werden Protokolle für bis zu zwei Tage gespeichert, beginnend um 00:00 Uhr GMT.

Wenn Sie die Zeitoption einbeziehen, müssen Sie Datum und Uhrzeit in Anführungszeichen setzen. Die Zeitoption verwendet GMT, die resultierenden Protokolldateien werden jedoch unter Verwendung der lokalen Zeitzone des Tableau Server-Computers geschrieben.

Beispiel: Wenn die lokale Zeitzone des Tableau Server-Computers PDT ist und Sie möchten, dass die Protokolldateien am 28.07.2022 um 7:00 Uhr PDT beginnen und um 19:00 Uhr PDT enden, verwenden Sie den folgenden Befehl:

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

-t, --with-netstat-info

Optional.

Schließt Netstat-Informationen ein.

 

Globale Optionen

-h, --help

Optional.

Hilfe zum Befehl anzeigen.

-p, --password <Kennwort>

Zusammen mit -u oder --username erforderlich, wenn keine Sitzung aktiv ist.

Geben Sie das Kennwort für den in -u oder --username angegebenen Benutzer an.

Wenn das Kennwort Leerzeichen oder Sonderzeichen enthält, schließen Sie es in Anführungszeichen ein:

--password "my password"

-s, --server https://<hostname>:8850

Optional.

Adresse, die für Tableau Services Manager verwendet wird. Die URL muss mit https beginnen, Port 8850 enthalten und den Servernamen nicht als IP-Adresse verwenden. Zum Beispiel https://<tsm_hostname>:8850. Wenn kein Server angegeben wird, dann wird https://<localhost | dnsname>:8850 verwendet.

--trust-admin-controller-cert

Optional.

Verwenden Sie dieses Flag, um dem selbstsignierten Zertifikat auf dem TSM-Controller zu vertrauen. Weitere Informationen zu vertrauenswürdigen Zertifikaten und CLI-Verbindungen finden Sie unter Verbinden von TSM-Clients.

-u, --username <Benutzer>

Zusammen mit -p oder --password erforderlich, wenn keine Sitzung aktiv ist.

Geben Sie ein Benutzerkonto an. Wenn Sie diese Option nicht einschließen, wird der Befehl mit den Anmeldeinformationen ausgeführt, mit denen Sie sich angemeldet haben.

 

Zurück zum Anfang
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.