War diese Seite hilfreich?
Ja Nein

tsm maintenance

Tableau Server für Windows beinhaltet nun Tableau Services Manager (TSM), der das Konfigurationsdienstprogramm und das tabadmin-Befehlszeilentool ersetzt. Wenn Sie Hilfe zu einer früheren Version von Tableau Server benötigen, schlagen Sie auf der Seite Tableau-Hilfe nach.

Mit den tsm maintenance-Befehlen können Sie Serververwaltungsaufgaben ausführen. Sie können beispielsweise regelmäßige 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), in der Metadaten zu Arbeitsmappen und Benutzern, Extraktdateien (.tde oder .hyper) und Serverkonfigurationsdaten enthalten sind. Siehe Durchführen einer vollständigen Sicherung und Wiederherstellen von Tableau Server.

Synopse

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

Optionen

-d, --append-date

Optional.

Hängt das aktuelle Datum an den Namen der Sicherungsdatei an.

-f, --file <Sicherungsdatei>

Erforderlich.

Schreibt die Sicherung in die angegebene Datei. Die Erweiterung .tsbak wird automatisch verwendet. Die Datei wird in das Verzeichnis geschrieben, das in der TSM-Variablen basefilepath.backuprestore definiert wurde. Dies ist 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.

-i, --description <Zeichenfolge>

Optional.

Schließt die angegebene Beschreibung der Sicherheitsdatei ein.

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

-k, --skip-verification

Optional.

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

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

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

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

Beispiele

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

tsm maintenance backup -f ts_backup -d

tsm maintenance cleanup

Hiermit löschen sie alte Protokolldateien und temporäre Dateien.

Wenn Sie Tableau Server in einer verteilten Umgebung ausführen, führen Sie diesen Befehl auf dem Knoten aus, auf dem der Administration Controller-Prozess angewendet wird (dieser wird auch als TSM-Controller bezeichnet). Standardmäßig befindet sich der Controller auf dem initialen Knoten im Cluster.

Der Zweck dieses Befehls besteht darin, in der Tableau-Bereitstellung durch Löschen alter Dateien Speicherplatz freizugeben. Daher wird durch die Ausführung dieses Befehls beim Starten des Servers die Mehrheit der alten Inhalte für dieses Szenario entfernt. Wenn Sie die aktuellen Protokolldateien entfernen möchten, müssen Sie den Server anhalten, bevor Sie diesen Befehl ausführen.

Hinweis: Dieser Befehl wurde in Tableau Server Version 10.5.1 hinzugefügt, und einige Optionen wurden in Version 2018.1 neu aufgenommen.

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.

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

Optional.

Löschen Sie Tabelleneinträge für HTTP-Anforderungen, die älter sind als diese Anzahl Tage. (Standardwert: 7 Tage)

-l, --log-files

Optional.

Löscht Protokolldateien, die älter als die retention-period sind. Dateien in Unterverzeichnissen von 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. Dieser Befehl kann nicht für temporäre Dateien verwendet werden.

-q, --http-requests-table

Optional.

Löschen Sie alte http_requests-Tabelleneinträge.

-r, --redis-cache

Optional.

Leeren Sie den Redis-Zwischenspeicher.

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

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

-t, --temp-files

Optional.

Löschen alle Dateien und Unterverzeichnisse in folgenden Verzeichnissen:

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\temp: Nur Verzeichnisse, die Dateien für abgelaufene (nicht ausgeführte) Sitzungen speichern, werden gelöscht.

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

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

-v, --verbose

Optional.

Zeigen Sie Details zu den Bereinigungen an.

Beispiele

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

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

tsm maintenance reindex-search

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

Synopse

tsm maintenance reindex-search [global options]

Option

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

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

tsm maintenance restore

Stellt Tableau Server mithilfe der angegebenen Sicherungsdatei wieder her. 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.

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. Dies ist 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.

-r, --restart-server

Optional.

Startet den Server nach der Wiederherstellung neu.

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

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

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

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

tsm maintenance send-logs

Laden Sie die angegebene Datei zu Tableau hoch, und weisen Sie ihr einen Support-Vorgang zu.

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. Der Standardwert beträgt 1800 (30 Minuten).

tsm maintenance validate-resources

Validieren Sie Arbeitsmappen und Datenquellen für eine Site.

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.

Reparieren Sie ungültige Ressourcen.

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

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

 

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.

Schließt alle Dateien außer PostgreSQL-Daten ein.

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

--description <Zeichenfolge>

Optional.

Schließt die angegebene Beschreibung der Archivdatei ein.

-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. Dies ist 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, --with-msinfo

Optional.

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

-l, --with-latest-dump

Optional.

Schließt die aktuellen Speicherauszugsdateien ein.

-m, --minimumdate <Datum>

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".

-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 <Zeitüberschreitung in Sekunden>

Optional.

Wartezeit, bis der Befehl abgeschlossen ist. Der Standardwert beträgt 1800 (30 Minuten).

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

Optional.

Adresse, die für Tableau Services Manager verwendet wird. Wenn kein Server angegeben wird, dann wird https://<localhost | dnsname>:8850 verwendet.

--trust-admin-controller-cert

Optional.

Mit diesem Flag geben Sie an, dass Sie dem selbstsignierten Zertifikat auf dem TSM-Controller vertrauen. Weitere Informationen zur Vertrauenswürdigkeit von Zertifikaten und Verbindungen über die Befehlszeilenschnittstelle finden Sie im Abschnitt 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.