Percorsi dei file di tsm

Alcuni comandi tsm leggono i file o scrivono su file in percorsi predefiniti. Questi percorsi predefiniti sono determinati dalle chiavi di configurazione basefilepath definite per ogni comando. Puoi utilizzare tsm per visualizzare il valore attuale delle chiavi e per modificare i percorsi.

Account di sistema NetworkService

In alcune organizzazioni vengono implementate politiche di sicurezza che limitano l’accesso ai file dagli account di sistema, come l’account NetworkService. Se modifichi i percorsi dei file di tsm, devi verificare che l’account di sistema NetworkService disponga dell’autorizzazione completa (con l’ereditarietà delle autorizzazioni abilitata) per il percorso risultante. Inoltre, se modifichi un percorso di file che era originariamente nel percorso *\data\tabsvc\*, devi mantenere le autorizzazioni di NetworkService per il percorso originale. Questa autorizzazione deve essere mantenuta perché l’account di sistema NetworkService gestisce le operazioni per Controller di amministrazione di Tableau Server, Servizio file client di Tableau Server e Servizio di coordinamento di Tableau Server.

Autorizzazioni per il percorso dei file di backup/ripristino

Autorizzazioni richieste per il percorso del file di backup/ripristino:

  • NetworkService: autorizzazione di lettura/scrittura/esecuzione
  • Account di servizio Esegui come: autorizzazione di lettura/scrittura/esecuzione

Percorsi predefiniti per i file

Durante il tsm maintenance backup, i processi restore, send-logs, ziplogs e i processi tsm sites export, sites import , Tableau Server utilizza i percorsi predefiniti per i file creati o utilizzati da questi comandi.

Per informazioni dettagliate sui requisiti di spazio su disco per il backup di Tableau Server, consulta Utilizzo dello spazio su disco per il backup.

Per impostazione predefinita:

  • Comandi tsm maintenance:

    • backup: il file di backup .tsbak viene creato in un percorso temporaneo nella directory dei dati sul nodo iniziale e quindi salvato in:

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

      Per impostazione predefinita, è:

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

      Ma se hai installato Tableau in una posizione non predefinita, sarà diverso. Ad esempio, se hai eseguito l’installazione in D:\Tableau Server, il backup verrà salvato in:

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

      Nota: il comando tsm maintenance backup non supporta i percorsi di file UNC (Universal Naming Convention) di Microsoft Windows, noti anche come "percorsi di rete" (\\<nome computer>\<cartella>\<nome file>) come percorso della posizione in cui vengono scritti i file di backup. Utilizza invece i percorsi del file system locale (<lettera unità>:\<nome cartella\<nome file>).

    • restore: il processo di ripristino ripristina un file di backup da:

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

      Per impostazione predefinita, è:

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

      Ma se hai installato Tableau in una posizione non predefinita, sarà diverso. Ad esempio, se hai installato su D:\Tableau Server il processo di ripristino utilizzerà il backup in:

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

    • send-logs: il send-logs invia il file di registro da:

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

      Per impostazione predefinita, è:

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

      Ma se hai installato Tableau in una posizione non predefinita, sarà diverso. Ad esempio, se hai installato su D:\Tableau Server il processo send-logs invierà i file di registro da:

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

    • ziplogs: il file ziplogs viene generato in:

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

      Per impostazione predefinita, è:

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

      Ma se hai installato Tableau in una posizione non predefinita, sarà diverso. Ad esempio, se hai installato su D:\Tableau Server il file ziplogs viene generato in:

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

  • tsm sites

    • export: il file di esportazione .zip viene generato nella seguente directory:

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

      Per impostazione predefinita, è:

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

      Ma se hai installato Tableau in una posizione non predefinita, sarà diverso. Ad esempio, se hai installato su D:\Tableau Server il file di esportazione .zip viene generato in:

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

    • import: durante il processo di importazione, Tableau Server cerca i file in:

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

      Per impostazione predefinita, è:

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

      Ma se hai installato Tableau in una posizione non predefinita, sarà diverso. Ad esempio, se hai installato su D:\Tableau Server il processo di importazione, cerca i file in:

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

Ottieni la posizione attuale del file

Puoi visualizzare il percorso attuale del file per un comando specifico utilizzando tsm configuration get:

  • Per i comandi tsm maintenance:

    • backup, restore e send-logs:

      tsm configuration get -k basefilepath.backuprestore

    • ziplogs:

      tsm configuration get -k basefilepath.log_archive

  • Per i comandi dei siti tsm:

    • export

      tsm configuration get -k basefilepath.site_export.exports

    • import

      tsm configuration get -k basefilepath.site_import.exports

Modifica il percorso del file attuale

Puoi modificare i percorsi dei file previsti utilizzando il comando tsm configuration set per aggiornare le variabili basefilepath. Per informazioni dettagliate sugli specifici percorsi dei file di base, consulta Opzioni di tsm configuration set.

Modificare la variabile basefilepath non comporta lo spostamento dei file esistenti dalla directory originale a quella nuova. Se desideri posizionare i file di backup, di ripristino, di registro o di esportazione dei siti nella nuova directory specificata, dovrai spostarli manualmente. Sei responsabile della creazione del nuovo percorso e dell’impostazione delle autorizzazioni corrette per consentire l’accesso a tsm a tutti i file che verranno inseriti in quel percorso e alla struttura di directory contenente tali file. Se modifichi il percorso del file di base di backup/ripristino, devi eseguire il comando tsm maintenance validate-backup-basefilepath (disponibile nella versione 2022.1 e successive) per verificare che le autorizzazioni siano impostate correttamente.

Il comando tsm maintenance backup assembla il backup in un percorso temporaneo nella directory dei dati, prima di salvare il file di backup nel percorso specificato dalla variabile basefilepath.backuprestore. La modifica del percorso del file di base non influisce sulla posizione in cui il comando tsm maintenance backup assembla il file di backup.

Non è possibile specificare una posizione basefilepath.backuprestore nella radice di un’unità. Deve essere in una cartella.

  • Per i comandi tsm maintenance:

    • Per modificare la directory per backup, ripristino o send-logs, esegui il seguente comando:

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

    • Per modificare la directory ziplogs:

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

  • Per i comandi dei siti tsm:

    • Per modificare la directory di esportazione dei siti:

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

    • Per modificare la directory di importazione dei siti:

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

Dopo aver modificato un percorso di file predefinito, devi eseguire le seguenti operazioni:

  1. Applica le modifiche in sospeso:

    tsm pending-changes apply

    Se le modifiche in sospeso richiedono il riavvio del server, il comando pending-changes apply visualizzerà un messaggio per segnalare che verrà eseguito un riavvio. Questo messaggio viene visualizzato anche se il server è stato arrestato, ma in questo caso il riavvio non viene eseguito. Puoi eliminare la richiesta usando l’opzione --ignore-prompt, ma questo non modifica il comportamento del riavvio. Se le modifiche non richiedono un riavvio, vengono applicate senza visualizzare alcun messaggio. Per maggiori informazioni, consulta tsm pending-changes apply.

  2. Arresta Tableau Server:

    tsm stop

  3. Riavvia il Controller TSM:

    net stop tabadmincontroller_0

    net start tabadmincontroller_0

  4. Attendi alcuni minuti il riavvio del controller. Puoi confermare che il controller si è riavviato con questo comando:

    tsm status -v

    Quando puoi eseguire il comando e il Controller di amministrazione di Tableau Server è elencato come "in esecuzione", il controller è stato riavviato.

  5. Avvia Tableau Server:

    tsm start

 

Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!