Guida di Tableau Server su Linux

Percorsi predefiniti per i file

Durante i processi tsm maintenance backup, restore e ziplogs e i processi tsm sites export e 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:

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

    • backup: percorso di staging temporaneo. Il file di backup .tsbak viene creato in un percorso temporaneo nella directory dei dati sul nodo iniziale.

      A partire dalla versione 2026.2.0, puoi specificare un percorso temporaneo alternativo per la creazione del file di backup. Può essere utile se il file di backup è di grandi dimensioni o se lo spazio sul nodo iniziale è limitato. Per maggiori informazioni, consulta backuprestore.use_custom_staging_dir.enabled.

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

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

  • ziplogs: il file ziplogs viene generato in:

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

• tsm sites

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

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

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

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

Ottenere il percorso attuale del file

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

• Per i comandi tsm maintenance:

  • backup e restore:

    tsm configuration get -k basefilepath.backuprestore

  • ziplogs:

    tsm configuration get -k basefilepath.log_archive

• Per i comandi tsm sites:

  • export

    tsm configuration get -k basefilepath.site_export.exports

  • import

    tsm configuration get -k basefilepath.site_import.exports

Modificare i percorsi attuali di basefilepath

Puoi modificare alcuni percorsi utilizzati da TSM per le azioni sui file tramite 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.

La modifica della variabile basefilepath non comporta lo spostamento di 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. Per maggiori informazioni sulle autorizzazioni e su tsm, consulta File e autorizzazioni in TSM. 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 utilizza un percorso di staging temporaneo nella directory dei dati per le azioni file (assemblaggio, estrazione) prima di salvare il file di backup nel percorso specificato dalla variabile basefilepath.backuprestore. A partire dalla versione 2026.2.0, se configuri TSM per utilizzare il percorso specificato da basefilepath.backuprestore, il backup viene assemblato in sottodirectory temporanee nel percorso specificato da basefilepath.backuprestore. Per le versioni precedenti alla 2026.2.0 la modifica di basefilepath non influisce sulla posizione in cui il comando tsm maintenance backup assembla il file di backup.

• Per i comandi tsm maintenance:

  • backup e restore

    Per modificare la directory utilizzata dai comandi backup e restore , esegui il comando seguente:

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

  • Percorso di staging di backup

    Nota: la possibilità di modificare il percorso di staging è disponibile a partire dalla versione 2026.2.0.

    Per modificare il percorso di staging temporaneo utilizzato da backup in subdirectory nel percorso di basefilepath.backuprestore, esegui questo comando:

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

    Se è impostato su true, il comando backup utilizza directory temporanee nel percorso specificato dal valore di basefilepath.backuprestore.

  • Per modificare la directory ziplogs:

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

• Per i comandi tsm sites:

  • Per modificare la directory di esportazione dei siti:

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

  • Per modificare la directory di importazione dei siti:

    tsm configuration set -k basefilepath.site_import.exports -v "/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 (come account di sistema tableau ):

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

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