Aide de Tableau Server sur Linux

Emplacements par défaut des fichiers

Pendant les processus tsm maintenance backup, restore, et ziplogs , ainsi que tsm sites export et sites import , Tableau Server utilise les emplacements par défaut des fichiers créés ou utilisés par ces commandes.

Pour plus de détails sur les exigences d’espace disque pour une sauvegarde Tableau Server, consultez Utilisation de l’espace disque pour la sauvegarde.

Par défaut :

• Commandes tsm maintenance :

  • backup— Le fichier de sauvegarde.tsbak est créé dans un emplacement temporaire dans le répertoire de données sur le nœud initial, puis enregistré dans :

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

    • backup— Emplacement intermédiaire temporaire. Le fichier de sauvegarde.tsbak est créé dans un emplacement temporaire dans le répertoire de données sur le nœud initial.

      Depuis la version 2026.2.0, vous pouvez spécifier un emplacement temporaire alternatif pour la création du fichier de sauvegarde, ce qui peut s’avérer utile si votre fichier de sauvegarde est volumineux ou si vous disposez d’un espace limité sur le nœud initial. Pour plus d’informations, consultez backuprestore.use_custom_staging_dir.enabled.

  • restore—Le processus de restauration restaure un fichier de sauvegarde depuis :

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

  • ziplogs—Le fichier ziplogs est généré dans :

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

• tsm sites

  • export—Le fichier .zip d’exportation est généré dans le répertoire suivant :

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

  • import—Pendant le processus d’importation, Tableau Server recherche les fichiers dans :

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

Obtenir l’emplacement actuel d’un fichier

Vous pouvez voir l’emplacement actuel d’un fichier pour une commande spécifique à l’aide de:tsm configuration get

• Pour les commandes tsm maintenance :

  • backup and restore :

    tsm configuration get -k basefilepath.backuprestore

  • ziplogs :

    tsm configuration get -k basefilepath.log_archive

• Pour les commandes tsm sites :

  • export

    tsm configuration get -k basefilepath.site_export.exports

  • import

    tsm configuration get -k basefilepath.site_import.exports

Modifier les emplacements actuels des chemins d’accès des fichiers de base

Vous pouvez modifier certains emplacements utilisés par TSM pour effectuer les actions sur les fichiers à l’aide de la commande tsm configuration set, afin de mettre à jour les variables basefilepath. Pour plus de détails sur des chemins d’accès de base à des fichiers spécifiques, consultez Options tsm configuration set.

La modification d’une variable basefilepath ne déplace pas les fichiers existants depuis le répertoire d’origine vers le nouveau répertoire. Si vous souhaitez que les fichiers de sauvegarde, les fichiers journaux, ou les fichiers d’exportation ou d’importation de sites existants résident dans le nouveau répertoire spécifié, vous devez les déplacer manuellement. Vous êtes responsable de la création du nouvel emplacement et de la configuration des autorisations correctes donnant un accès tsm à tous les fichiers qui seront placés ici, et à la structure de répertoire contenant ces fichiers. Pour plus d’informations sur les autorisations et tsm, consultez Fichiers et autorisations dans TSM. Si vous modifiez le chemin du fichier de base de sauvegarde/restauration, vous devez exécuter la commande tsm maintenance validate-backup-basefilepath (disponible dans la version 2022.1 et ultérieure) pour vérifier que les autorisations sont correctement définies.

Les commandes tsm maintenance backup utilisent un emplacement intermédiaire temporaire dans le répertoire de données pour effectuer les actions sur les fichiers (assemblage, extraction) avant d’enregistrer le fichier de sauvegarde à l’emplacement spécifié par la variable basefilepath.backuprestore. À partir de la version 2026.2.0, si vous configurez TSM pour utiliser l’emplacement spécifié par basefilepath.backuprestore, et que la sauvegarde est assemblée en sous-répertoires temporaires à l’emplacement spécifié par basefilepath.backuprestore. Pour les versions antérieures à 2026.2.0, la modification du chemin d’accès du fichier de base n’a pas d’impact sur l’emplacement où la commande tsm maintenance backup assemble le fichier de sauvegarde.

• Pour les commandes tsm maintenance :

  • backup et restore

    Pour modifier le répertoire utilisé par les commandes backup et restore , , exécutez la commande suivante :

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

  • Emplacement temporaire de backup

    Remarque : L’emplacement intermédiaire peut être modifié à partir de la version 2026.2.0.

    Pour remplacer l’emplacement intermédiaire temporaire utilisé par backup par des sous-répertoires situés dans basefilepath.backuprestore, exécutez la commande suivante :

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

    Lorsqu’elle est définie sur true, la commande backup utilise des répertoires temporaires à l’emplacement spécifié par la valeur basefilepath.backuprestore.

  • Pour modifier le stockage de fichiers ziplogs :

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

• Pour les commandes tsm sites :

  • Pour modifier le répertoire d’exportation des sites :

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

  • Pour modifier le répertoire d’importation des sites :

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

Si vous avez modifié l’emplacement par défaut des fichiers, vous devez procéder comme suit :

1. Appliquez les modifications en attente :

   tsm pending-changes apply

   Si les modifications en attente nécessitent un redémarrage du serveur, la commande pending-changes apply affichera une invite pour vous informer qu’un redémarrage va avoir lieu. Cette invite s’affiche même si le serveur est arrêté, mais dans ce cas, il n’y a pas de redémarrage. Vous pouvez supprimer l’invite à l’aide de l’option --ignore-prompt, mais cela ne modifiera pas le comportement de redémarrage. Si les modifications ne nécessitent pas de redémarrage, les modifications sont appliquées sans invite. Pour plus d’informations, consultez tsm pending-changes apply.

2. Arrêtez Tableau Server :

   tsm stop

3. Redémarrez le contrôleur TSM (en tant que compte système tableau) :

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

4. Patientez quelques minutes pendant le redémarrage du contrôleur. Vous pouvez vérifier que le contrôleur a redémarré à l’aide de cette commande :

   tsm status -v

   Lorsque vous pouvez exécuter cette commande et que le contrôleur d’administration Tableau Server apparaît comme étant « en cours d’exécution », le contrôleur a redémarré.

5. Démarrez Tableau Server :

   tsm start