tsm-bestandspaden

Bepaalde tsm-opdrachten lezen bestanden van of schrijven bestanden naar standaardlocaties. Deze standaardlocaties worden bepaald door basefilepath-configuratiesleutels gedefinieerd voor elke opdracht. U kunt tsm gebruiken om de huidige waarde van de sleutels te bekijken en om de locaties te wijzigen.

Standaardlocaties voor bestanden

Tijdens de tsm maintenance backup-, restore-, - en ziplogs -processen, en de tsm sites export- en sites import -processen, gebruikt Tableau Server standaardlocaties voor de bestanden die door deze opdrachten worden gemaakt of gebruikt.

Voor details over de vereisten voor schijfruimte voor het maken van back-ups van Tableau Server, zie Schijfruimte gebruiken voor back-up maken.

Standaard:

  • tsm maintenance-opdrachten:

    • backup—Het .tsbak-back-upbestand wordt gemaakt op een tijdelijke locatie in de datadirectory op het initiële knooppunt en vervolgens opgeslagen in:

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

      • backup—Tijdelijke staginglocatie. Het .tsbak-back-upbestand wordt gemaakt op een tijdelijke locatie in de datadirectory op het initiële knooppunt.

        Vanaf versie 2026.2.0 kunt u een alternatieve tijdelijke locatie opgeven voor het maken van het back-upbestand. Dit kan handig zijn als uw back-upbestand groot is of als u weinig ruimte hebt op het eerste knooppunt. Zie backuprestore.use_custom_staging_dir.enabled voor meer informatie.

    • restore—Het herstelproces herstelt een back-upbestand van:

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

    • ziplogs—Het ziplogs-bestand wordt gegenereerd in:

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

  • tsm sites

    • export—Het export-.zip-bestand wordt gegenereerd in de volgende directory:

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

    • import—Tijdens het importproces zoekt Tableau Server naar bestanden in:

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

De huidige bestandslocatie ophalen

U kunt de huidige bestandslocatie voor een specifieke opdracht bekijken met behulp van tsm configuration get:

  • Voor tsm maintenance-opdrachten:

    • backup and restore:

      tsm configuration get -k basefilepath.backuprestore

    • ziplogs:

      tsm configuration get -k basefilepath.log_archive

  • Voor tsm sites-opdrachten:

    • export

      tsm configuration get -k basefilepath.site_export.exports

    • import

      tsm configuration get -k basefilepath.site_import.exports

Huidige basefilepath-locaties wijzigen

U kunt de sommige locaties die door TSM worden gebruikt voor bestandsacties wijzigen met behulp van de tsm configuration set-opdracht om de basefilepath-variabelen bij te werken. Zie tsm configuration set-opties voor meer informatie over specifieke basisbestandspaden.

Als u een basefilepath-variabele wijzigt, worden er daardoor geen bestaande bestanden van de oorspronkelijke directory naar de nieuwe directory verplaatst. Als u bestaande back-up-, herstel-, logboekbestanden of site-export- of -importbestanden in de nieuwe directory wilt plaatsen die u opgeeft, moet u deze handmatig verplaatsen. U bent verantwoordelijk voor het maken van de nieuwe locatie en voor het instellen van de juiste machtigingen om tsm-toegang te verlenen tot alle bestanden die daar worden geplaatst, en tot de directorystructuur waarin deze bestanden staan. Zie Bestanden en machtigingen in TSM voor meer informatie over machtigingen en tsm. Als u het basisbestandspad voor back-up/herstel wijzigt, moet u de opdracht tsm maintenance validate-backup-basefilepath uitvoeren (beschikbaar in versie 2022.1 en hoger) om te controleren of de machtigingen correct zijn ingesteld.

De opdracht tsm maintenance backup gebruikt een tijdelijke staginglocatie in de datadirectory voor bestandsacties (samenstelling, extractie) voordat het back-upbestand wordt opgeslagen op de locatie die is opgegeven door de basefilepath.backuprestore-variabele . Vanaf versie 2026.2.0 wordt de back-up geassembleerd in tijdelijke submappen onder de locatie die is opgegeven door basefilepath.backuprestoreals u TSM configureert om de locatie te gebruiken die is opgegeven door basefilepath.backuprestore. Voor versies ouder dan 2026.2.0 is het wijzigen van het basisbestandspad niet van invloed op waar de tsm maintenance backup-opdracht het back-upbestand samenstelt.

  • Voor tsm maintenance-opdrachten:

    • backup en restore

      Als u de directory wilt wijzigen die wordt gebruikt door de opdrachten backup en restore , voert u de volgende opdracht uit:

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

    • backup staginglocatie

      Opmerking: de mogelijkheid om de staginglocatie te wijzigen is beschikbaar vanaf versie 2026.2.0.

      Om de tijdelijke staginglocatie die wordt gebruikt door backup te wijzigen naar submappen onder de locatie basefilepath.backuprestore, voert u de volgende opdracht uit:

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

      Wanneer ingesteld op true, gebruikt de opdracht backup tijdelijke directory's onder de locatie die is opgegeven door de waarde basefilepath.backuprestore.

    • Om de ziplogsdirectory te wijzigen:

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

  • Voor tsm sites-opdrachten:

    • Om de exportdirectory van de site te wijzigen:

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

    • Om de importdirectory van de site te wijzigen:

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

Nadat u een standaardbestandslocatie hebt gewijzigd, moet u het volgende doen:

  1. Lopende wijzigingen toepassen:

    tsm pending-changes apply

    Als voor de in behandeling zijnde wijzigingen de server opnieuw moet worden opgestart, geeft de opdracht pending-changes apply een prompt weer om u te laten weten dat de server opnieuw wordt gestart. Deze prompt verschijnt ook als de server is gestopt, maar in dat geval vindt er geen herstart plaats. U kunt de prompt onderdrukken met de optie --ignore-prompt, maar dit verandert niets aan het herstartgedrag. Als opnieuw opstarten niet nodig is voor de wijzigingen, worden de wijzigingen zonder waarschuwing van een prompt toegepast. Zie tsm pending-changes apply voor meer informatie.

  2. Tableau Server stoppen:

    tsm stop

  3. De TSM-controller opnieuw opstarten (als tableau-systeemaccount):

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

  4. Wacht enkele minuten totdat de controller opnieuw is opgestart. Met deze opdracht kunt u bevestigen dat de controller opnieuw is opgestart:

    tsm status -v

    Wanneer u die opdracht kunt uitvoeren en de Tableau Server - Beheercontroller in de lijst staat als 'wordt uitgevoerd', is de controller opnieuw opgestart.

  5. Tableau Server starten:

    tsm start

 

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.