tsm maintenance


Vous pouvez utiliser les commandes tsm maintenance pour gérer les tâches de maintenance du serveur, par exemple créer des sauvegardes ou restaurer Tableau Server à partir d’une sauvegarde créée récemment.

tsm maintenance backup

Crée une sauvegarde des données gérées par Tableau Server. Ces données incluent la base de données PostgreSQL Tableau (le référentiel) qui contient les métadonnées des classeurs et des utilisateurs, ainsi que les fichiers d’extraits (fichiers .hyper, ou .tde pour les versions 2024.2 et antérieures). Ces données n’incluent pas les données de configuration. Consultez Effectuer une sauvegarde et une restauration complètes de Tableau Server.

Remarque : n’utilisez pas cette commande sur les installations de Tableau Server qui utilisent un stockage de fichiers externe. Voir Sauvegarde et restauration avec un stockage de fichiers externe.

Optimisation des configurations de topologie :

  • La co-localisation du stockage de fichiers sur le même nœud que le contrôleur d’administration peut réduire la durée nécessaire à la sauvegarde de Tableau Server en réduisant ou en éliminant la nécessité de transférer des données entre les nœuds pendant le processus de sauvegarde. Cela est particulièrement vrai si votre organisation utilise de nombreux extraits.
  • La co-localisation du référentiel (pgsql) avec le nœud Contrôleur d’administration peut également aider à réduire la durée de sauvegarde, mais les économies de temps sont moins importantes qu’avec le magasin de fichiers.

Le contrôleur d’administration se trouve généralement sur le nœud initial, à moins que vous n’ayez eu une défaillance initiale du nœud et que vous ayez déplacé le contrôleur vers un autre nœud.

Le fichier de sauvegarde est assemblé dans un emplacement temporaire dans le répertoire de données, puis écrit sur le répertoire défini dans la variable TSM basefilepath.backuprestore

/var/opt/tableau/tableau_server/data/tabsvc/files/backups/<filename>.tsbak

Pour plus d’informations sur l’emplacement d’écriture des fichiers de sauvegarde et la manière de les modifier, consultez Chemins d’accès des fichiers tsm. Remarque : même lorsque vous modifiez l’emplacement de sauvegarde, le processus de sauvegarde utilise un emplacement temporaire dans le répertoire de données pour assembler le fichier de sauvegarde.

Synopsis

tsm maintenance backup --file <backup_file> [options] [global options]

Options

-f, --file <backup_file>

Obligatoire.

Pour plus d’informations sur la sauvegarde des données de référentiel, consultez Sauvegarder les données Tableau Server pour plus d’informations.

-d, --append-date

Facultatif.

Ajoutez la date en cours à la fin du nom du fichier de sauvegarde.

Remarque : les sauvegardes créées à l’aide d’une programmation incluent automatiquement une date/heure au début du nom du fichier de sauvegarde. Si vous utilisez également l’option-d, le nom de votre fichier inclura deux fois la date. Pour plus de détails sur la programmation des sauvegardes, consultez Programmation et gestion des sauvegardes.

-i, --description <string>

Facultatif.

Incluez la description spécifiée du fichier de sauvegarde.

--ignore-prompt

Facultatif. Ajouté dans la version 2020.2.

Sauvegardez sans invite, même si le stockage de fichiers n’est pas sur le même nœud que le contrôleur d’administration (généralement le nœud initial). Utilisez cette invite si vous automatisez des sauvegardes (par exemple, avec des scripts).

-k, --skip-verification

Facultatif.

Ne pas vérifier l’intégrité de la sauvegarde de base de données.

--multithreaded

Facultatif. Ajouté dans la version 2021.1

Par défaut, une seule unité d’exécution est utilisée lors de la création d’une sauvegarde Tableau Server. Lorsque cette option est spécifiée, une sauvegarde est créée à l’aide de plusieurs unités d’exécution. Deux unités d’exécution sont utilisées par défaut lorsque cette option est spécifiée. Vous pouvez modifier le nombre d’unités d’exécution utilisées en définissant la clé de configuration backup.zstd.thread_count.

--override-disk-space-check

Facultatif.

Tentez de créer une sauvegarde même si un avertissement d’espace disque faible s’affiche.

-po, --pg-only

Facultatif.

Génère uniquement la sauvegarde du référentiel.

Important : N’utilisez pas l’option pg-only lors de la génération d’une sauvegarde, sauf indication contraire de l’assistance Tableau. Cette option permet de sauvegarder uniquement le référentiel et ne doit pas être utilisée pour restaurer votre serveur. Son utilisation principale est le dépannage, et l’assistance Tableau vous demandera de créer une sauvegarde --pg-only si cela est nécessaire.

--request-timeout <timeout in seconds>

Facultatif.

Nombre de secondes avant la fin de la commande. La valeur par défaut est 86400 (1 440 minutes).

-sd, --schedule-days <day[,day]>

Facultatif. Ajouté dans la version 2020.4.

Jours d’exécution de la programmation. Utilisez 1-7 pour une programmation hebdomadaire (1 pour le lundi, 7 pour le dimanche), 1-31 pour les programmations mensuelles (si un mois n’inclut pas le jour spécifié, le dernier jour du mois est utilisé). Utilisez une virgule pour séparer plusieurs valeurs.

-si, --schedule-id <ID>

Facultatif. Ajouté dans la version 2020.4.

Spécifiez l’ID d’une programmation existante que vous souhaitez mettre à jour.

--skip-compression

Facultatif.

Créez une sauvegarde sans utiliser de compression. Ceci entraîne un fichier de sauvegarde plus volumineux, mais peut réduire la durée nécessaire à la réalisation de la sauvegarde. Si vous utilisez ce paramètre dans une installation multi-nœuds, nous vous recommandons vivement d’avoir une instance du stockage de fichiers configurée sur votre nœud initial.

-sn, --schedule-name <name>

Facultatif. Ajouté dans la version 2020.4.

Spécifiez le nom d’une programmation que vous créez ou mettez à jour.

-sr, --schedule-recurrence <frequency>

Facultatif. Ajouté dans la version 2020.4.

Fréquence de récurrence de la programmation. Les options valables sont « quotidien », « hebdomadaire » ou « mensuel ».

-st, --schedule-time <HH :MM>

Facultatif. Ajouté dans la version 2020.4.

L’heure d’exécution d’une programmation, au format 24 heures : HH :MM.

Exemples

Cet exemple crée une sauvegarde appelée ts_backup-<yyyy-mm-dd>.tsbak dans le /var/opt/tableau/tableau_server/data/tabsvc/files/backups/ répertoire :

tsm maintenance backup -f ts_backup -d

Cet exemple crée une programmation de sauvegarde hebdomadaire récurrente appelée « weekly-saturday-backup » qui s’exécute tous les samedis à midi et crée une sauvegarde appelée <yyyy.mm.dd.hh.mm>-ts_saturday_backup.tsbak :

tsm maintenance backup -f ts_saturday_backup -sr weekly -st 12:00 -sd 6 -sn weekly-saturday-backup

Pour plus de détails sur la gestion des sauvegardes programmées, consultez Programmation et gestion des sauvegardes.

tsm maintenance cleanup

Par défaut, la commande tsm maintenance cleanup supprime les fichiers temporaires et les fichiers journaux datant de plus d’un jour. Les options de commande peuvent modifier la durée de conservation ainsi que les fichiers supprimés.

L’impact de la commande cleanup diffère selon que Tableau Server est en cours d’exécution ou non.

  • Si le serveur exécute la plupart des fichiers anciens et que les entrées de table http_requests peuvent être supprimées, mais que tous les fichiers en cours d’utilisation (verrouillés par le système d’exploitation) ne peuvent pas être supprimés, les fichiers temporaires et les fichiers journaux actifs ne sont pas supprimés. Pour supprimer les fichiers temporaires et les fichiers journaux actuels, vous devez arrêter le serveur avant d’exécuter cette commande. Pour supprimer les entrées de table http_requests, utilisez l’option -q.
  • Si le serveur est arrêté les entrées http_requests ne peuvent pas être supprimées.

Si vous exécutez Tableau Server sur un déploiement distribué, exécutez cette commande sur le nœud exécutant le processus du contrôleur d’administration (également appelé Contrôleur TSM). Par défaut, et dans la plupart des cas, le contrôleur se trouve sur le nœud initial du groupement.

Remarque : cette commande a été ajoutée dans Tableau Server version 10.5.1 et certaines options ont été ajoutées dans la version 2018.1.

Synopsis

tsm maintenance cleanup [options] [global options]

Options

-a, --all

Facultatif.

Effectuez toutes les opérations de nettoyage avec les valeurs de rétention par défaut. Équivaut à l’exécution de la commande cleanup avec les options suivantes: -l -t -r -q -ic.

--http-requests-table-retention <# of days>

Facultatif.

Par défaut : 7 jours

Spécifiez le nombre de jours d’entrées de table http_requests à conserver. Utilisez cette option avec l’option -q pour spécifier le nombre de jours d’entrées de table à conserver, en remplaçant la valeur par défaut de 7 jours. Cette option indique la durée de rétention des entrées de la table, mais ne déclenche pas la suppression des entrées de table. Utilisez-la avec l’option -q, qui déclenche la suppression des entrées.

-ic, --sheet-image-cache-image

Facultatif. Ajouté dans la version 2019.4.

Effacez le cache d’images. Ce cache peut contenir des images pour les aperçus hors ligne, les instantanés pour les messages d’abonnements par courriel et les PDF d’abonnement, ainsi que toutes les images demandées au point de terminaison de l’API REST de publication (voir rest_api_ref.htm(Le lien s’ouvre dans une nouvelle fenêtre) pour plus d’informations).

-l, --log-files

Facultatif.

Supprimez les fichiers journaux remontant à plus d’un jour. Les fichiers qui se trouvent dans les sous-répertoires sous data/tabsvc/logs seront supprimés.

--log-files-retention <# of days>

Facultatif.

Par défaut : 1 (24 heures)

Supprimez les fichiers journaux plus anciens que ce nombre de jours. Utilisez cette option pour remplacer la période de conservation par défaut de 1 jour. Cette commande ne s’affiche pas aux fichiers temporaires.

-q, --http-requests-table

Facultatif.

Supprimez les anciennes entrées de la table http_requests. Tableau Server doit être en cours d’exécution pour que les entrées de table puissent être supprimées. Cette option est ignorée si Tableau Server est arrêté. Cette option peut être utilisée seule pour spécifier la suppression des entrées plus anciennes que la période de rétention par défaut (7 jours) ou avec l’option --http-requests-table-retention pour spécifier une période de rétention autre que celle par défaut.

Remarque : la suppression des entrées de table http_requests supprime définitivement les données disponibles pour les vues administratives personnalisées. Assurez-vous que la suppression de ces données n’aura pas d’incidence sur les vues personnalisées dont vous avez besoin.

-r, --redis-cache

Facultatif.

Effacez le cache Redis.

--request-timeout <timeout in seconds>

Facultatif.

Valeur par défaut : 3600

Attendez la durée spécifiée d’exécution de la commande.

-t, --temp-files

Facultatif.

Supprimez tous les fichiers et sous-répertoires dans les répertoires suivants :

  • /var/opt/tableau/tableau_server/data/tabsvc/temp : Pour supprimer les fichiers sous chaque répertoire de processus Tableau Server, vous devez arrêter Tableau Server avant d’exécuter la commande. Si vous exécutez la commande pendant que Tableau Server s’exécute, seuls les répertoires stockant les fichiers des sessions expirées (non exécutés) seront supprimés.

  • /var/opt/tableau/tableau_server/data/tabsvc/httpd/temp

  • /var/opt/tableau/tableau_server/temp

Exemples

Cet exemple montre comment nettoyer tous les fichiers journaux remontant à plus de 2 jours :

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance jmx disable

Version : commande ajoutée dans la version 2022.1.

Utilisez la commande tsm maintenance jmx disable pour désactiver JMX sur Tableau Server.

L’exécution de cette commande nécessite un redémarrage de Tableau Server, y compris les services TSM.

Synopsis

tsm maintenance jmx disable [options] [global options]

Options

--ignore-prompt

Facultatif.

Désactivez la commande JMX sans invite.

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance jmx enable

Version : commande ajoutée dans la version 2022.1.

Utilisez la commande tsm maintenance jmx enable pour activer JMX sur Tableau Server.

Cette commande est interactive, et vous demande les options applicables si vous ne les fournissez pas comme paramètres de ligne de commande.

L’exécution de cette commande nécessite un redémarrage de Tableau Server, y compris les services TSM.

Synopsis

tsm maintenance jmx enable

Options

--access <readonly | readwrite>

Facultatif.

Activez JMX avec un accès en lecture seule ou un accès en lecture-écriture. La valeur par défaut est readonly.

--ignore-prompt

Facultatif.

Activez JMX sans avoir à fournir d’autres options de sécurité. Cette action active JMX avec SSL et redémarre Tableau Server si vous n’incluez aucune autre option de commande. Par exemple :

tsm maintenance jmx enable --ignore-prompt

--no-ssl

Facultatif.

Activez JMX sans SSL.

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

--ssl-client-auth

Facultatif.

Activez JMX en exigeant une authentification client pour SSL.

--unsecured

Facultatif.

Activez JMX sans activer les fonctionnalités de sécurité (cette opération est déconseillée). Revient à définir la clé de configuration service.jmx_enabled sur true dans les versions antérieures à 2022.1.

tsm maintenance metadata-services disable

Version : commande ajoutée dans la version 2019.3.

Utilisez la commande tsm maintenance metadata-services disable pour activer l’API de métadonnées Tableau.

Désactiver l’API de métadonnées arrête l’ingestion et l’indexage en continu de l’information relative au contenu Tableau Server, supprime l’index de l’information relative au contenu publié sur Tableau Server ainsi que les ressources associées à ce contenu, et désactive la possibilité d’interroger l’API de métadonnées et d’accéder à Tableau Catalog.

L’exécution de cette commande arrête et démarre certains services utilisés par Tableau Server, ce qui rend certaines fonctionnalités, telles que les Recommandations, temporairement indisponibles pour vos utilisateurs.

Synopsis

tsm maintenance metadata-services disable

Option

--ignore-prompt

Facultatif.

Désactivez l’invite de confirmation lorsque vous désactivez l’API de métadonnées.

tsm maintenance metadata-services enable

Version : commande ajoutée dans la version 2019.3.

Utilisez la commande tsm maintenance metadata-services enable pour activer l’API de métadonnées Tableau pour Tableau Server.

Si Tableau Server est sous licence avec l’option Gestion des données, activer l’API de métadonnées active également Tableau Catalog.

Lors de l’activation de l’API de métadonnées, l’information sur le contenu Tableau Server est ingérée et ensuite indexée dans le magasin de l’API de métadonnées. L’API de métadonnées peut être utilisée pour interroger le schéma, le lignage et les métadonnées gérées par l’utilisateur pour le contenu publié dans Tableau Server . Une fois l’API de métadonnées activée, les métadonnées sont ingérées et indexées en continu jusqu’à ce que l’API Metadata soit désactivée.

Lors de l’exécution de cette commande, gardez à l’esprit ce qui suit :

  • L’exécution de cette commande arrête et démarre certains services utilisés par Tableau Server, ce qui rend certaines fonctionnalités, telles que les Recommandations, temporairement indisponibles pour vos utilisateurs.
  • Un nouvel index de métadonnées est créé et remplace l’index précédent chaque fois que cette commande est utilisée.

Pour plus d’informations sur Tableau Catalog, consultez À propos de Tableau Catalog.

Synopsis

tsm maintenance metadata-services enable

Option

--ignore-prompt

Facultatif.

Désactivez l’invite de confirmation lorsque vous activez l’API de métadonnées.

tsm maintenance metadata-services get-status

Version : commande ajoutée dans la version 2019.3.

Utilisez la commande tsm maintenance metadata-services get-status pour obtenir l’information sur l’état des services de métadonnées.

L’état des services de métadonnées indique si le magasin de l’API de métadonnées a été initialisé ou si l’API de métadonnées Tableau est en cours d’exécution ou non.

Synopsis

tsm maintenance metadata-services get-status

tsm maintenance reindex-search

Utilisez la commande tsm maintenance reindex-search pour reconstituer l’index de recherche.

Synopsis

tsm maintenance reindex-search [options] [global options]

Option

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance reset-searchserver

Version : Cette commande a été retirée (supprimée) dans la version 2023.3.0 lorsque la fonction Rechercher et parcourir (également appelé serveur de recherche) a été retirée. La fonction Rechercher et parcourir a été remplacée par le serveur d’indexation et de recherche.

Remarque : L’exécution de cette commande sur la version 2023.3.0 ou ultérieure ne fera rien.

Réinitialise le serveur de recherche à un état propre, en supprimant l’information de recherche et reconstituant l’index de recherche.

Synopsis

tsm maintenance reset-searchserver [options] [global options]

Option

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance restore

Restaurez Tableau Server à l’aide du fichier de sauvegarde spécifié. La restauration d’un fichier de sauvegarde ne restaure aucune donnée de configuration. Consultez Effectuer une sauvegarde et une restauration complètes de Tableau Server.

Vous pouvez uniquement restaurer à partir d’une sauvegarde présentant le même type de banque d’identités que le serveur en cours d’exécution. Par exemple, une sauvegarde à partir d’un serveur utilisant l’authentification locale peut être restaurée sur une instance Tableau Server initialisée avec l’authentification locale, mais une sauvegarde depuis un serveur utilisant l’authentification Active Directory ne peut pas être restaurée sur un serveur initialisé avec l’authentification locale.

À partir de la version 2022.3, les sauvegardes créées à l’aide de tabadmin (« sauvegardes avant TSM ») ne sont pas prises en charge. Vous ne pouvez pas restaurer une sauvegarde avant TSM vers la version 2022.3 de Tableau Server ou une version ultérieure.

Synopsis

tsm maintenance restore --file <file_name> [--restart-server] [global options]

Options

-f, --file <file_name>

Obligatoire.

Spécifie le fichier de sauvegarde depuis lequel effectuer la restauration.

La commande restore attend un fichier de sauvegarde dans le répertoire défini dans la variable TSM basefilepath.backuprestore. Par défaut :

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

Pour plus d’informations sur les chemins d’accès des fichiers et la manière de les modifier, consultez Chemins d’accès des fichiers tsm.

-ak, --asset-key-file <file_name>

Facultatif. Obsolète dans la version 2021.4.0.

Spécifiez cette option uniquement si vous effectuez une restauration depuis des ressources créées par tabadmin sur Tableau Server (versions 2018.1 et antérieures).

Nom du fichier de la clé de ressource depuis lequel effectuer la restauration. Le fichier de la clé de ressource est créé par la commande tabadmin assetkeys. Le fichier doit se trouver dans l’emplacement de sauvegarde/restauration prédéfini sur le serveur.

-k, --skip-identity-store-verification

Facultatif. Spécifiez cette option uniquement si vous effectuez une restauration depuis un fichier de sauvegarde créée par tabadmin sur Tableau Server (versions 2018.1 et antérieures).

N’utilisez pas cette clé pour tenter de modifier le type de magasin d’identités de Tableau Server qui a créé le fichier de sauvegarde d’origine. Pour modifier le magasin d’identités, consultez Changement de magasin d’identités.

-po, --pg-only

Facultatif.

Restaure uniquement le référentiel.

-r, --restart-server

Facultatif.

Redémarrez le serveur après la restauration.

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance send-logs

Téléversez le fichier spécifié sur Tableau et associez-le à une demande d’assistance. Pour téléverser des fichiers correctement vers Tableau, votre Tableau Server doit être capable de communiquer avec le serveur d’envoi des fichiers journaux à l’adresse https://report-issue.tableau.com.

Synopsis

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

Options

-c,--case <case_number>

Obligatoire.

Numéro de la demande d’assistance.

-e,--email <contact_email>

Obligatoire.

Courriel de contact.

-f, --file <path/to/Fichier>

Obligatoire.

Spécifie l’emplacement et le nom du fichier créé par l’archive de fichier journal à envoyer.

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance snapshot-backup complete

Version : commande ajoutée dans la version 2020.1 et disponible uniquement lorsque Tableau Server est configuré pour le stockage de fichiers externe.

Effectuez le processus de sauvegarde d’instantané dans Tableau Server. Exécutez cette commande après avoir pris une sauvegarde d’instantané de votre stockage externe.

Les commandes tsm maintenance snapshot-backup prepare et tsm maintenance snapshot-backup complete permettent de créer une sauvegarde des données de Tableau Server pour les installations de Tableau Server qui sont configurées avec un stockage de fichiers externe. Pour plus d’information, consultez Sauvegarde et restauration avec un stockage de fichiers externe

Synopsis

tsm maintenance snapshot-backup complete [options] [global options]

Options

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance snapshot-backup prepare

Version : commande ajoutée dans la version 2020.1 et disponible uniquement lorsque Tableau Server est configuré pour le stockage de fichiers externe.

Prépare la sauvegarde de l’instantané. Une fois l’étape de préparation terminée, vous pouvez effectuer une sauvegarde d’instantané de votre stockage réseau.

Les commandes tsm maintenance snapshot-backup prepare et tsm maintenace snapshot-backup complete permettent de créer une sauvegarde des données de Tableau Server pour les installations de Tableau Server qui sont configurées avec un stockage de fichiers externe. Pour plus d’information, consultez Sauvegarde et restauration avec un stockage de fichiers externe

Synopsis

tsm maintenance snapshot-backup prepare [options] [global options]

Options

--include-pg-backup

Facultatif. Ajouté dans la version 2021.1. Les versions précédentes incluaient toujours une sauvegarde du référentiel externe.

Facultatif.

Une sauvegarde du référentiel est effectuée et copiée sur le partage réseau. Cela ne s’applique qu’aux déploiements où le référentiel externe et le stockage de fichiers externe sont configurés. Pour plus d’information, consultez Sauvegarde et restauration avec un stockage de fichiers externe.

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance snapshot-backup restore

Version : commande ajoutée dans la version 2020.1 et disponible uniquement lorsque Tableau Server est configuré pour le stockage de fichiers externe.

Restaure la sauvegarde du référentiel à partir de l’instantané de stockage sur Tableau Server.

Pour plus d’information, consultez Sauvegarde et restauration avec un stockage de fichiers externe.

Synopsis

tsm maintenance snapshot-backup restore [options] [global options]

Options

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance validate-backup-basefilepath

Version : commande ajoutée dans la version 2022.1.

Vérifiez que l’emplacement du chemin d’accès au fichier de base de la sauvegarde/restauration dispose des autorisations appropriées pour permettre que la sauvegarde et la restauration fonctionnent correctement. Exécutez cette commande après avoir défini le chemin du fichier de base pour la sauvegarde et la restauration. Pour plus d’informations, consultez Modifier l’emplacement actuel d’un fichier.

Synopsis

tsm maintenance validate-backup-basefilepath [options][global options]

Options

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance validate-resources

Valide les classeurs et les sources de données pour un site. Utilisez cette commande avant de migrer un site, pour détecter les problèmes avec les ressources du site telles que les classeurs et les sources de données qui entraîneront l’échec de l’importation d’un site. Certains problèmes de ressources peuvent être corrigés en republiant à partir de sources locales. D’autres problèmes pourraient nécessiter l’aide de l’assistance Tableau.

Synopsis

tsm maintenance validate-resources --site-id <site ID> [global options]

Options

-id,--site-id <site ID>

Obligatoire.

ID du site dont vous validez les ressources.

-r,--repair

Facultatif.

Tentez de réparer les ressources non valides. Celles qui ne peuvent pas être réparées sont indiquées dans la sortie.

--request-timeout <timeout in seconds>

Facultatif.

Attendez la durée spécifiée d’exécution de la commande.

tsm maintenance ziplogs

Utilisez la commande ziplogs pour créer une archive des fichiers journaux de Tableau Server.

Remarque : Si vous ne pouvez pas exécuter les commandes de fichiers journaux auto-décompressables correctement, vous pouvez compresser manuellement les fichiers journaux Tableau Server. Pour plus d’informations, consultez Dépannage des problèmes de Tableau Server sur Linux.

Synopsis

tsm maintenance ziplogs [options] [global options]

Options

-a, --all

Facultatif.

Incluez tous les fichiers sauf les données PostgreSQL.

-d, --with-postgresql-data

Facultatif.

Incluez le dossier de données PostgreSQL si Tableau Server est arrêté ou les fichiers de vidage PostgreSQL si Tableau Server est en cours d’exécution. Cet indicateur est ignoré pour les déploiements exécutés avec un Référentiel externe Tableau Server.

--enddate "<mm/jj/aaaa H:mm>"

Facultatif. Option d’heure (H:mm) ajoutée dans la version 2021.4.0.

La date la plus proche des fichiers journaux à inclure. Cette option doit être utilisée avec --startdate et ne peut pas être utilisée avec l’option --minimumdate. Si cette option n’est pas spécifiée, jusqu’à deux jours de fichiers journaux seront inclus, à partir de 00 :00 TU.

Si vous incluez l’option d’heure, vous devez utiliser des guillemets autour de la date et de l’heure. L’option d’heure utilise le TU, cependant, les fichiers journaux résultants seront écrits en utilisant le fuseau horaire local de l’ordinateur Tableau Server.

Exemple : si le fuseau horaire local de l’ordinateur Tableau Server porte le nom d’heure avancée du Pacifique (HAP) et que vous souhaitez que les fichiers journaux commencent à 7h00, HAP, et se terminent à 19h00, HAP, le 28/07/2022, utilisez ce qui suit :

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

-f, --file <name>

Facultatif.

Spécifiez le nom du fichier archive compressé. Si aucun nom n’est fourni, l’archive est créée en tant que logs.zip. Le fichier est écrit sur le répertoire défini dans la variable TSM basefilepath.log_archive. Par défaut :

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

Pour plus d’informations sur les chemins d’accès des fichiers et la manière de les modifier, consultez Chemins d’accès des fichiers tsm.

-i, --description <string>

Facultatif.

Incluez la description spécifiée du fichier archive.

-l, --with-latest-dump

Facultatif.

En cas de panne d’un service, Tableau Server génère un fichier de vidage. Définissez cette option de manière à inclure le fichier de vidage le plus récent d’une panne de service. Si vous ne configurez pas cette option, aucun fichier de vidage ne sera inclus dans le fichier journal auto-décompressable résultant.

-m, --minimumdate <mm/dd/yyyy>

Facultatif.

La date la plus proche des fichiers journaux à inclure. Si elle n’est pas spécifiée, un maximum de deux jours de fichiers journaux est inclus. Le format de date doit être « mm/dd/yyyy ». Cette option ne peut pas être utilisée avec --startdate et --enddate ou --all.

--nodes

Facultatif. Ajouté dans la version 2020.3.

Spécifiez les nœuds pour lesquels créer un fichier auto-décompressable. S’ils ne sont pas spécifiés, les fichiers auto-décompressables sont créées pour tous les nœuds et enregistrés sur le nœud initial. Séparez les nœuds par une virgule. Par exemple, pour collecter les fichiers journaux pour les nœuds 2 et 4 :

tsm maintenance ziplogs --nodes node2,node4

-o, --overwrite

Facultatif.

Permet de remplacer un fichier journal auto-décompressable existant. S’il existe déjà un fichier du même nom et que cette option n’est pas utilisée, la commande des fichiers journaux auto-décompressables échouera.

Par défaut, le fichier est écrit sur :

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

Pour plus d’informations sur les chemins d’accès des fichiers et la manière de les modifier, consultez Chemins d’accès des fichiers tsm.

--request-timeout <seconds>

Facultatif.

Nombre de secondes avant la fin de la commande. La valeur par défaut est 7200 (120 minutes).

--startdate "<mm/jj/aaaa H:mm>"

Facultatif. Option d’heure (H:mm) ajoutée dans la version 2021.4.0.

La date la plus proche des fichiers journaux à inclure. Cette option doit être utilisée avec --enddate et ne peut pas être utilisée avec l’option --minimumdate. Si cette option n’est pas spécifiée, jusqu’à deux jours de fichiers journaux seront inclus, à partir de 00 :00 TU.

Si vous incluez l’option d’heure, vous devez utiliser des guillemets autour de la date et de l’heure. L’option d’heure utilise le TU, cependant, les fichiers journaux résultants seront écrits en utilisant le fuseau horaire local de l’ordinateur Tableau Server.

Exemple : si le fuseau horaire local de l’ordinateur Tableau Server porte le nom d’heure avancée du Pacifique (HAP) et que vous souhaitez que les fichiers journaux commencent à 7h00, HAP, et se terminent à 19h00, HAP, le 28/07/2022, utilisez ce qui suit :

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

 

Options globales

-h, --help

Facultatif.

Affichez l’aide de la commande.

-p, --password <password>

Requis, en même temps que -u ou --username si aucune session n’est active.

Spécifiez le mot de passe de l’utilisateur spécifié dans -u ou --username.

Si le mot de passe inclut des espaces ou des caractères spéciaux, mettez-le entre guillemets :

--password 'my password'

-s, --serveur https://<hostname>:8850</hostname>

Facultatif.

Utilisez l’adresse spécifiée pour Tableau Services Manager. L’URL doit commencer par https, inclure le port 8850 et utiliser le nom de serveur, et non l’adresse IP. Par exemple, https://<tsm_hostname>:8850. Si aucun serveur n’est spécifié, https://<localhost | dnsname>:8850 est présupposé.

--trust-admin-controller-cert

Facultatif.

Utilisez cet indicateur pour approuver le certificat auto-signé sur le contrôleur TSM. Pour plus d’informations sur les connexions d’approbation de certificat et d’interface en ligne de commande, reportez-vous à la rubrique Connexion des clients TSM.

-u, --username <user>

Requis si aucune session n’est active, en même temps que -p ou --password.

Spécifiez un compte utilisateur. Si vous n’incluez pas cette option, la commande s’exécute à l’aide des informations d’identification avec lesquelles vous vous êtes connecté.

 

Retour en haut
Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!