tsm-Dateipfade

Bestimmte tsm-Befehle lesen oder schreiben Dateien, die an Standardspeicherorten gespeichert sind oder werden. Diese Standardspeicherorte werden von den basefilepath-Konfigurationsschlüsseln festgelegt, die für jeden Befehl definiert sind. Sie können den tsm-Befehl zum Anzeigen des aktuellen Werts der Schlüssel und zum Ändern der Speicherorte verwenden.

Standardspeicherorte für Dateien

Während der Prozesse tsm maintenance backup, restore, und ziplogs sowie der Prozesse tsm sites export und sites import nutzt Tableau Server die Standardspeicherorte für die Dateien, die von diesen Befehlen erstellt oder verwendet werden.

Weitere Informationen zu den Speicherplatzanforderungen für die Sicherung von Tableau Server finden Sie unter Speicherplatznutzung für die Sicherung.

Dies ist standardmäßig:

  • tsm-Wartungsbefehle:

    • backup: Die .tsbak-Sicherungsdatei wird an einem temporären Speicherort in dem Datenverzeichnis auf dem Primärknoten erstellt und dann gespeichert in:

      /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

      • backup: Temporärer Staging-Speicherort. Die .tsbak-Sicherungsdatei wird an einem temporären Speicherort in dem Datenverzeichnis auf dem Primärknoten erstellt.

        Ab Version 2026.2.0 können Sie einen alternativen temporären Speicherort für die Erstellung der Sicherungsdatei angeben. Dies kann nützlich sein, wenn Ihre Sicherungsdatei groß ist oder wenn es auf dem Primärknoten nur begrenzten Speicherplatz gibt. Weitere Informationen finden Sie unter backuprestore.use_custom_staging_dir.enabled.

    • Restore: Im Wiederherstellungsprozess wird eine Sicherungsdatei wiederhergestellt aus:

      /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

    • ziplogs: Die "ziplogs"-Datei wird im folgenden Verzeichnis erstellt:

      /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives

  • tsm sites

    • export: Die .zip-Exportdatei wird im folgenden Verzeichnis erstellt:

      /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports

    • import: Während des Importprozesses sucht Tableau Server im folgenden Verzeichnis nach Dateien:

      /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports

Abrufen des aktuellen Dateispeicherorts

Sie können den aktuellen Dateispeicherort für einen bestimmten Befehl mithilfe von tsm configuration get anzeigen:

  • Für tsm-Wartungsbefehle:

    • backup und restore:

      tsm configuration get -k basefilepath.backuprestore

    • ziplogs:

      tsm configuration get -k basefilepath.log_archive

  • Für tsm-Site-Befehle:

    • export

      tsm configuration get -k basefilepath.site_export.exports

    • import

      tsm configuration get -k basefilepath.site_import.exports

Ändern der aktuellen basefilepath -Speicherorte

Einige der Speicherorte, die von TSM für Dateiaktionen verwendet werden, können Sie ändern, indem Sie mit dem Befehl tsm configuration set die basefilepath-Variablen aktualisieren. Weitere Informationen zu bestimmten Basisdateipfaden finden Sie unter tsm configuration set-Optionen.

Das Ändern einer basefilepath-Variablen bewirkt nicht, dass vorhandene Dateien aus dem Originalverzeichnis in das neue Verzeichnis verschoben werden. Wenn Sie vorhandene Sicherungs-, Wiederherstellungs-, Protokoll-, Site-Export- oder Site-Importdateien in das neue von Ihnen festgelegte Verzeichnis verschieben möchten, müssen Sie dies manuell tun. Sie sind für das Erstellen des neuen Speicherorts und für das Festlegen der richtigen Berechtigungen verantwortlich, um den tsm-Zugriff auf die hier platzierten Dateien und die Verzeichnisstruktur zu erlauben, die diese Dateien enthält. Weitere Informationen über Berechtigungen und tsm finden Sie unter Dateien und Berechtigungen in TSM. Wenn Sie den Basisdateipfad für die Sicherung/Wiederherstellung ändern, sollten Sie den Befehl tsm maintenance validate-backup-basefilepath (verfügbar ab Version 2022.1) ausführen, um zu überprüfen, ob die Berechtigungen ordnungsgemäß festgelegt sind.

Der Befehl tsm maintenance backup verwendet einen temporären Staging-Speicherort im Datenverzeichnis für Dateiaktionen (Assemblierung, Extraktion), bevor die Sicherungsdatei an dem von der Variablen basefilepath.backuprestore angegebenen Speicherort gespeichert wird. Ab Version 2026.2.0: Wenn Sie TSM zur Verwendung des durch basefilepath.backuprestore angegebenen Speicherortes konfigurieren, wird die Sicherung in temporären Unterverzeichnissen unter dem durch basefilepath.backuprestoreangegebenen Speicherort zusammengestellt. Bei Versionen vor 2026.2.0 hat ein Ändern des Basisdateipfads („basefilepath“) hat keine Auswirkungen darauf, wo der Befehl tsm maintenance backup die Sicherungsdatei zusammenstellt.

  • Für tsm-Wartungsbefehle:

    • backup und restore

      Um das von den Befehlen backup und restore verwendete Verzeichnis führen Sie den folgenden Befehl aus:

      tsm configuration set -k basefilepath.backuprestore -v "/new/directory/path"

    • backup Staging-Speicherort

      Hinweis: Die Möglichkeit, den Staging-Speicherort zu ändern, ist ab Version 2026.2.0 verfügbar.

      Führen Sie den folgenden Befehl aus, um den temporären Staging-Speicherort zu ändern, der von backup in Unterverzeichnisse unter dem basefilepath.backuprestore-Speicherort verwendet wird:

      tsm configuration set -k backuprestore.use_custom_staging_dir.enabled -v true

      Wenn diese Option auf true gesetzt ist, verwendet der backup -Befehl temporäre Verzeichnisse unter dem durch den basefilepath.backuprestore-Wert angegebenen Speicherort.

    • Zum Ändern des "ziplogs"-Verzeichnisses:

      tsm configuration set -k basefilepath.log_archive -v "/new/directory/path"

  • Für tsm-Site-Befehle:

    • Zum Ändern des Site-Exportverzeichnisses:

      tsm configuration set -k basefilepath.site_export.exports -v "/new/directory/path"

    • Zum Ändern des Site-Importverzeichnisses:

      tsm configuration set -k basefilepath.site_import.exports -v "/new/directory/path"

Nachdem Sie einen standardmäßigen Speicherort geändert haben, müssen Sie Folgendes vornehmen:

  1. Nehmen Sie ausstehende Änderungen vor:

    tsm pending-changes apply

    Wenn die ausstehenden Änderungen einen Neustart des Servers erfordern, zeigt der Befehl pending-changes apply eine Meldung an, um Sie darüber zu informieren, dass ein Neustart stattfinden wird. Diese Meldung wird auch angezeigt, wenn der Server angehalten ist. In diesem Fall erfolgt jedoch kein Neustart. Sie können diese Meldung mithilfe der Option --ignore-prompt unterdrücken, dies ändert jedoch nichts an dem Neustartverhalten. Wenn die Änderungen keinen Neustart erfordern, werden die Änderungen ohne Meldung angewendet. Weitere Informationen finden Sie unter tsm pending-changes apply.

  2. Beenden Sie Tableau Server:

    tsm stop

  3. Starten Sie den TSM-Controller neu (als tableau-Systemkonto):

    sudo su -l tableau -c "systemctl --user restart tabadmincontroller_0.service"

  4. Warten Sie mehrere Minuten, bis der Controller neu gestartet wird. Mit dem folgenden Befehl können Sie den Neustart des Controllers bestätigen:

    tsm status -v

    Wenn Sie diesen Befehl ausführen und Tableau Server Administration Controller als 'running' angezeigt wird, wurde der Controller neu gestartet.

  5. Starten Sie Tableau Server:

    tsm start

 

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.