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.

NetworkService-systeemaccount

In sommige organisaties wordt beveiligingsbeleid geïmplementeerd dat de bestandstoegang van systeemaccounts, zoals het NetworkService-account, beperkt. Als u tsm-bestandspaden wijzigt, moet u verifiëren dat het NetworkService-systeemaccount een volledige machtiging heeft (waarbij machtigingsovername is ingeschakeld) voor het resulterende pad. Als u bovendien een bestandspad wijzigt dat zich oorspronkelijk in het *\data\tabsvc\*-pad bevond, moet u de NetworkService-machtigingen voor het oorspronkelijke pad behouden. Deze machtiging moet behouden blijven omdat het NetworkService-systeemaccount bewerkingen afhandelt met Tableau Server - Beheercontroller, Tableau Server - Clientbestandsservice en Tableau Server - Coördinatieservice.

Machtigingen voor de back-up-/herstelbestandslocatie

Vereiste machtigingen voor de back-up-/herstelbestandslocatie:

  • NetworkService: lees-/schrijf-/uitvoeringsmachtiging
  • 'Uitvoeren als service'-account: lees-/schrijf-/uitvoeringsmachtiging

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:

      <install drive>:<install\path>\data\tabsvc\files\backups

      Standaard is dit:

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

      Maar als u Tableau op een niet-standaardlocatie hebt geïnstalleerd, zal dit anders zijn. Als u bijvoorbeeld op D:\Tableau Server hebt geïnstalleerd, wordt de back-up opgeslagen in:

      D:\Tableau Server\data\tabsvc\files\backups

      Opmerking: De opdracht tsm maintenance backup ondersteunt geen Microsoft Windows UNC (Universal Naming Convention)-bestandspaden, ook wel 'netwerkpaden' genoemd ( \\<computer name> \<folder>\<file name>) als het pad naar de locatie waar back-upbestanden worden geschreven. Gebruik in plaats daarvan lokale bestandssysteempaden (<drive letter>:\<folder name\<file name>).

      • 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:

      <install drive>:<install\path>\data\tabsvc\files\backups

      Standaard is dit:

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

      Maar als u Tableau op een niet-standaardlocatie hebt geïnstalleerd, zal dit anders zijn. Als u bijvoorbeeld op D:\Tableau Server hebt geïnstalleerd, gebruikt het herstelproces een back-up uit:

      D:\Tableau Server\data\tabsvc\files\backups

    • ziplogs—Het ziplogs-bestand wordt gegenereerd in:

      <install drive>:<install\path>\data\tabsvc\files\log-archives

      Standaard is dit:

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

      Maar als u Tableau op een niet-standaardlocatie hebt geïnstalleerd, zal dit anders zijn. Als u bijvoorbeeld op D:\Tableau Server hebt geïnstalleerd, wordt het ziplogbestand gegenereerd in:

      D:\Tableau Server\data\tabsvc\files\log-archives

  • tsm sites

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

      <install drive>:<install\path>\data\tabsvc\files\siteexports

      Standaard is dit:

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

      Maar als u Tableau op een niet-standaardlocatie hebt geïnstalleerd, zal dit anders zijn. Als u bijvoorbeeld op D:\Tableau Server hebt geïnstalleerd, wordt het export-zipbestand gegenereerd in:

      D:\Tableau Server\data\tabsvc\files\siteexports

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

      <install drive>:<install\path>\data\tabsvc\files\siteimports

      Standaard is dit:

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

      Maar als u Tableau op een niet-standaardlocatie hebt geïnstalleerd, zal dit anders zijn. Als u bijvoorbeeld op D:\Tableau Server hebt geïnstalleerd, zoekt het importproces bestanden in:

      D:\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. 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.

U kunt geen basefilepath.backuprestore-locatie opgeven in de root van een drive. Deze moet zich in een map bevinden.

  • 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 "<drive>:\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 "<drive>:\new\directory\path"

  • Voor tsm sites-opdrachten:

    • Om de exportdirectory van de site te wijzigen:

      tsm configuration set -k basefilepath.site_export.exports -v "<drive>:\new\directory\path"

    • Om de importdirectory van de site te wijzigen:

      tsm configuration set -k basefilepath.site_import.exports -v "<drive>:\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:

    net stop tabadmincontroller_0

    net start tabadmincontroller_0

  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.