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:
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.Arresta Tableau Server:
tsm stop
Riavvia il Controller TSM:
net stop tabadmincontroller_0
net start tabadmincontroller_0
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.
Avvia Tableau Server:
tsm start