Aide de Tableau Server sur Linux

Le journal d’installation. app-install.log, se trouve dans /var/opt/tableau/tableau_server/logs.

Le journal de mise à niveau, app-upgrade.log, se trouve dans/var/opt/tableau/tableau_server/logs.

Plusieurs tentatives d’installation échouent

Si vous tentez d’installer Tableau Server et que l’installation échoue, toute tentative suivante d’installation risque d’échouer à moins que vous n’exécutiez le script tableau-server-obliterate pour éliminer Tableau de l’ordinateur.

Une tentative d’installation infructueuse peut laisser l’ordinateur dans un état susceptible d’entraîner l’échec des tentatives suivantes, avec des erreurs qui ne semblent pas directement liées à une précédente tentative d’installation. Voici une erreur possible :

Enabling and starting all services
+ services=(appzookeeper* tabadmincontroller* tabsvc* licenseservice* fnplicenseservice* tabadminagent* clientfileservice*)
+ systemctl_user enable appzookeeper_0.service 'tabadmincontroller*' 'tabsvc*' 'licenseservice*' fnplicenseservice_0.service 'tabadminagent*' 'clientfileservice*'
++ id -ru a_tabadminpoc
+ local unprivileged_uid=222954
+ su -l a_tabadminpoc -c 'XDG_RUNTIME_DIR=/run/user/222954 systemctl --user enable appzookeeper_0.service tabadmincontroller* tabsvc* licenseservice* fnplicenseservice_0.service tabadminagent* clientfileservice*'
Failed to execute operation: No such file or directory

Pour corriger ce problème, exécutez le script tableau-server-obliterate afin de nettoyer toute trace de la précédente tentative d’installation, puis redémarrez l’ordinateur. Pour plus d’informations, consultez Exécution du script tableau-server-obliterate.

Important : si vous avez créé une sauvegarde de Tableau (<file>.tsbak) que vous souhaitez conserver (par exemple pour la restaurer sur votre nouvelle installation), copiez ce fichier dans un emplacement sûr sur un autre ordinateur pour qu’il ne soit pas supprimé lors du nettoyage de votre ordinateur Tableau.

L’installation échoue du fait de la configuration matérielle

Tableau Server ne peut pas être installé si l’ordinateur sur lequel vous effectuez l’installation ne possède pas la configuration matérielle minimale requise. Les exigences s’appliquent à tous les ordinateurs sur lesquels vous installez Tableau Server. Pour plus de détails sur la configuration matérielle minimale requise, consultez Configuration matérielle minimale requise et recommandée pour Tableau Server.

L’installation ou la mise à niveau échoue du fait de la configuration du processeur

Depuis la version 2020.4.0, Tableau Server exige que tous les processeurs prennent en charge les ensembles d’instructions SSE4.2 et POPCNT. Vous ne pouvez pas installer ou mettre à niveau Tableau Server 2020.4.0 ou ultérieur sur des ordinateurs dont les processeurs ne prennent pas en charge ces ensembles d’instructions.

Vous pouvez voir ce message d’erreur en procédant à une nouvelle installation, ou en préparant la mise à niveau d’une installation existante : 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

Les ensembles d’instructions SSE4.2 et POPCNT sont courants depuis plus de 10 ans et la plupart des processeurs récents les prennent en charge. Mais si vous recevez une erreur liée aux exigences minimales du processeur lorsque vous essayez d’installer ou de mettre à niveau Tableau Server sur une machine virtuelle (VM), il est possible que le mode de compatibilité du processeur soit activé sur le VM. Pour installer ou mettre à niveau Tableau avec succès sur une machine virtuelle, assurez-vous que le mode de compatibilité du processeur est désactivé.

Emplacement des journaux de mise à niveau

Les cartes ne s’affichent pas ou s’affichent incomplètement après la mise à niveau

Depuis Tableau version 2019.2, les exigences d’accès à Internet ont changé pour les cartes. Si vous mettez à niveau de la version 2019.1.x ou antérieure à la version 2019.2.x ou ultérieure, et que les cartes ne s’affichent pas comme prévu, vérifiez que votre environnement est configuré pour permettre l’accès sur le port 443 à mapsconfig.tableau.com et api.mapbox.com.

Dans la version 2019.1.x ou antérieure, l’accès était nécessaire pour maps.tableausoftware.com.

Pour plus de détails sur les exigences d’accès à Internet, consultez Communication avec Internet.

Erreur de script mise à niveau : « Tableau Server Version change validation failed. » (Le changement de version de Tableau Server n’a pas pu être validé)

Lors de la mise à niveau, si vous exécutez le script upgrade-tsm par depuis le répertoire scripts.<version_code> pour la version antérieure, la mise à niveau échouera avec une erreur :

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

Si cette erreur s’affiche, modifiez le répertoire scripts.<version_code>pour la version que vous venez d’installer et exécutez le script à partir de là.

Lors de la mise à niveau sur plusieurs nœuds, l’initialisation d’un nœud supplémentaire échoue avec l’erreur « Enter your credentials again »

Si vous tentez d’initialiser un nœud supplémentaire lors de la mise à niveau de Tableau Server et que cette erreur s’affiche :

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

cela indique que le nœud ne peut pas se connecter au nœud initial, ni communiquer avec lui. Ce phénomène peut avoir plusieurs causes :

• Les informations d’identification que vous avez saisies ne sont pas valides, ou vous avez fait un erreur de saisie. Les informations d’identification doivent appartenir à un utilisateur doté d’autorisations administratives sur l’ordinateur sur lequel Tableau Server a été installé initialement. Vous n’avez pas besoin d’utiliser les informations d’identification de l’utilisateur qui a créé le fichier bootstrap, mais si vous le faites, vous avez l’assurance d’utiliser des informations d’identification valides.

• Le pare-feu local de l’ordinateur que vous tentez d’ajouter n’autorise pas la communication avec le nœud initial. Pour plus d’informations, consultez Configuration du pare-feu local.

La mise à niveau échoue du fait d’un espace disque insuffisant

Si l’espace disque est insuffisant pour que le programme d’installation de Tableau Server s’exécute et effectue la mise à niveau, l’installation échoue. La quantité d’espace disque requis dépend de la taille de votre base de données de référentiel, ainsi que du nombre et de la taille de vos extraits.

Pour libérer de l’espace disque :

1. Créez un instantané d’archive de journaux à l’aide de la commande tsm maintenance ziplogs.

   Après avoir créé le fichier ziplogs, conservez-le en lieu sûr, en dehors de votre installation de Tableau Server.

2. Nettoyez tous les fichiers inutiles à l’aide de la commande tsm maintenance cleanup. Pour plus d’informations, consultez Supprimer les fichiers superflus.

Échec de la mise à niveau lors du travail RebuildSearchIndex

Depuis la version 2020.1.x, l’étape finale d’une mise à niveau consiste à reconstruire l’index de recherche. À ce stade, tous les services ont été mis à niveau, donc si ce travail échoue, vous pouvez réinitialiser manuellement le serveur de recherche en exécutant la commande tsm maintenance reset-searchserver. Vous n’avez pas besoin d’effacer et de recommencer.

L’erreur sera :

An error occurred while rebuilding search index.

Pour réinitialiser le serveur de recherche :

1. Sur le nœud initial, ouvrez une session de terminal.

   Il doit s’agir d’une nouvelle session de terminal car le script de mise à niveau met à jour l’environnement du système pour la nouvelle version.

2. Reconstruisez l’index de recherche à l’aide de la commande tsm maintenance reset-searchserver.

La mise à niveau échoue sur 2022.1 et versions ultérieures

Après la mise à niveau de Tableau Server 2022.1 (ou version ultérieure), la restauration d’une sauvegarde Tableau Server dans le cadre de votre processus de mise à niveau peut provoquer l’erreur suivante :

« La sauvegarde ne peut pas être restaurée car Tableau Server utilise les nouvelles tables de service d’identité par défaut. »

Ce problème se produit car Tableau Server 2022.1 (et versions ultérieures) utilise un schéma d’identité différent du schéma d’identité utilisé par la sauvegarde. Pour résoudre ce problème, consultez Résoudre les problèmes liés à la migration d’identité.

La mise à niveau échoue sur la version 2020.4.0 ou ultérieure

Depuis la version 2020.4.0, la fonctionnalité de mise à niveau des points de contrôle vous permet de tenter à nouveau une mise à niveau qui avait échoué. En général, cette fonctionnalité est plus utile pour les administrateurs de serveur expérimentés et les professionnels de l’informatique qui sont à l’aise avec les fichiers journaux Tableau Server et sont prêts à effectuer des recherches dans ces journaux. La fonctionnalité peut par contre aider dans toutes les mises à niveau qui ont échoué, car elle vous permet de réexécuter le script upgrade-tsm. Le script sera en outre exécuté à partir de la dernière étape réussie, ce qui vous permet de gagner du temps. Pour les utilisateurs expérimentés, il est éventuellement possible d’identifier des problèmes tels que des problèmes d’espace disque, ou des problèmes d’autorisations, de les corriger et de réexécuter la mise à niveau.

Si vous passez à la version 2020.4.0 ou ultérieure et que la mise à niveau échoue, les étapes suivantes peuvent vous aider à terminer la mise à niveau :

• Réexécutez le script upgrade-tsm. Les échecs de mise à niveau sont parfois dues à l’expiration du délai d’attente pendant le processus de mise à niveau, et la réexécution du script peut permettre à la mise à niveau de passer outre les problèmes de synchronisation intermittents ou occasionnels. C’est aussi une étape sûre et facile. La réexécution du script ne peut pas avoir d’impact négatif, et au pire, la mise à niveau échouera à nouveau au même point, mais sans nécessiter de repasser par les étapes précédentes.

  Le script est installé dans le répertoire \scripts :

  opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm

  Si votre mise à niveau Tableau Server échoue lorsque vous réexécutez le script upgrade-tsm et que vous êtes à l’aise avec les journaux Tableau Server, vous pouvez appliquer ces étapes de dépannage supplémentaires :

• Examinez la sortie du script dans la fenêtre de commande .. Des messages d’erreur utiles peuvent vous aider à identifier la cause de l’échec de la mise à niveau et vous indiquer quelques pistes pour corriger le problème.

• Consultez le fichier app-upgrade.log. Toutes les erreurs affichées à la ligne de commande apparaîtront également dans le fichier app-upgrade.log, souvent avec plus de détails.

• Consultez le fichier tabadmincontroller.log. Les problèmes de mise à niveau qui ne sont pas facilement identifiables dans les deux cas ci-dessus sont probablement le résultat d’un problème dans un travail. Le fichier tabadmincontroller.log peut contenir des informations supplémentaires qui vous aident à diagnostiquer le problème.

  Remarque : pour plus d’informations sur l’emplacement des fichiers journaux, consultez Journaux et emplacement des fichiers journaux Tableau Server.

La mise à niveau échoue en raison de problèmes d’autorisation avec l’emplacement du fichier de sauvegarde/restauration

Avec les versions de Tableau Server antérieures à 2022.1.0, si l’emplacement du fichier de sauvegarde/restauration ne dispose pas des autorisations appropriées, le script de mise à niveau échouera avec une erreur indiquant qu’il est impossible de lire le fichier de sauvegarde ou de restaurer le référentiel.

À partir de la version 2022.1, le script upgrade confirme les autorisations de l’emplacement du fichier pour le fichier de sauvegarde/restauration avant de démarrer la mise à niveau. Le fichier pourra ainsi être écrit et lu depuis l’emplacement lors de la mise à niveau vers la nouvelle version de Tableau Server.

Les erreurs seront de ce type :

The tableau user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

L’emplacement utilisé par TSM pour la sauvegarde et la restauration est défini par la clé de configuration basefilepath.backuprestore et a une valeur par défaut que le programme d’installation configure avec les autorisations correctes. Ces dernières peuvent être affectées par les règles informatiques de l’entreprise ou si vous utilisez un emplacement que vous avez créé vous-même. Une nouvelle commande disponible à partir de 2022.1 vous permet de vérifier les autorisations sur l’emplacement du fichier de sauvegarde/restauration immédiatement après sa création, afin d’éviter tout problème lié aux autorisations. Pour plus de détails sur cette commande, consultez tsm maintenance validate-backup-basefilepath.

Pour plus de détails sur le chemin d’accès du fichier de sauvegarde/restauration, voir Chemins d’accès des fichiers tsm.

La mise à niveau réussit, mais les sources de données publiées ne sont pas accessibles

Dans des scénarios limités et spécifiques, après la mise à niveau de Tableau Server de la version 2021.3 vers les premières versions de 2023.1 ou 2023.3, les tentatives de connexion ou d’actualisation des sources de données publiées existantes échouent avec cette erreur :

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

Cela peut se produire dans les cas suivants :

1. Vous mettez à niveau une installation de Tableau Server qui était la version 2021.3.x à un moment quelconque (vous pouviez exécuter 2021.3 ou avoir effectué une mise à niveau de 2021.3 vers une version 2022.x)
   
   et

2. Vous mettez à niveau cette installation vers les premières versions de 2023.1 ou 2023.3

Aucun impact

Il n’y a aucun problème dans les cas suivants :

• Dans tous les autres chemins de mise à niveau depuis 2021.3

• Dans tous les autres chemins de mise à niveau vers 2023.1 ou 2023.3

• Dans toutes les nouvelles installations de 2023.1 et 2023.3

Informations complémentaires

Depuis le 16 septembre 2024, toutes les versions problématiques ont été supprimées du site de téléchargement. Si vous devez effectuer une mise à niveau vers la version 2023.1.x ou 2023.3.x, effectuez une mise à niveau vers les versions de maintenance 2023.1.16 ou supérieures, ou 2023.3.9 ou supérieures.

Pour plus d’informations sur ce problème, consultez Problème connu(Le lien s’ouvre dans une nouvelle fenêtre).

Problèmes courants d’importation de paramètres

>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

Vérifier que vous avez accès au serveur de licences

Le 6 octobre 2018, le service de licence de Tableau a déménagé vers un nouveau data center. Cela signifie que tous les environnements qui exigeaient une configuration spéciale (liste sûre des adresses IP statiques par exemple) pour accéder à licensing.tableau.com ou licensing.tableausoftware.com devront être mis à jour pour que vous puissiez activer, actualiser ou désactiver une clé produit Tableau.

Pour tester l’accès, saisissez l’URL et le port du serveur de licences dans un navigateur :

https://licensing.tableau.com:443

et :

https://atr.licensing.tableau.com/_status/healthz

Si vous êtes en mesure d’accéder au serveur, un message « Test success » s’affiche pour le premier serveur, et un message « OK » s’affiche pour le second.

Tableau Server a besoin de se connecter aux emplacements Internet suivants à des fins de gestion des licences :

• atr.licensing.tableau.com:443

• licensing.tableau.com:443

• register.tableau.com:443

• o.ss2.us

• s.ss2.us

• crt.rootca1.amazontrust.com

• crt.sca1b.amazontrust.com

• crt.sca0a.amazontrust.com

• crt.sca1a.amazontrust.com

• crt.sca2a.amazontrust.com

• crt.sca3a.amazontrust.com

• crt.sca4a.amazontrust.com

• *.digicert.com

• ocsp.*.amazontrust.com

• crl.*.amazontrust.com

• crt.rootg2.amazontrust.com

Les demandes envoyées aux domaines ci-dessus peuvent être sur le port 80 ou 443. Le port 80 est utilisé pour la validation des certificats (révocation, chaîne de certificats, etc.). Le port 443 est utilisé pour les connexions SSL.

Les demandes envoyées aux domaines ocsp.*.amazontrust.com et crl.*.amazontrust.com sont gérés par Amazon pour les informations de révocation de certificat. Voir Caractéristiques d’un certificat ACM(Le lien s’ouvre dans une nouvelle fenêtre) pour plus d’informations. Nous vous recommandons d’installer les certificats racine Amazon dans le magasin de certificats approuvés sur l’ordinateur exécutant Tableau. Pour télécharger et installer les certificats racines Amazon, consultez Autorités de certification(Le lien s’ouvre dans une nouvelle fenêtre) sur le site Web d’Amazon Trust Services.

Vérifiez la date et l’heure

Vérifiez que la date et l’heure sur l’ordinateur Tableau Server initial sont correctes. Si l’horloge est réglée sur une date et heure antérieures à la date actuelle, Tableau Server ne peut pas être activé.

Forcez une nouvelle lecture de la clé produit

1. Sur l’ordinateur Tableau Server initial, connectez-vous en tant qu’utilisateur doté d’un accès sudo.

2. Choisissez par exemple le répertoire bin de Tableau Server. Par défaut, il s’agit du suivant :

   /opt/tableau/tableau_server/packages/bin.<version_code>/

3. Entrez les commandes suivantes :

   tsm stop
   
   ./lmreread
   tsm start

Envoyer le contenu du stockage approuvé au support Tableau

Si les services de licence FlexNet sont installés et en cours d’exécution, mais qu’une erreur continue à s’afficher, il y a peut-être un problème avec les informations de clé produit Tableau. Afin de résoudre ce problème, effectuez les étapes suivantes pour créer un fichier contenant les informations de clé enregistrées dans le stockage approuvé.

1. Sur l’ordinateur Tableau Server initial, connectez-vous en tant qu’utilisateur doté d’un accès sudo.

2. Entrez la commande suivante :

   serveractutil -view > <machine_name>-LicResults.txt

   Ceci crée le fichier <machine_name>-LicResults.txt dans votre répertoire actuel. Si vous ne disposez pas d’autorisations en écriture pour cet emplacement et qu’une erreur s’affiche, basculez sur un emplacement où vous êtes autorisé à créer un fichier et exécutez à nouveau la commande.

3. Contactez l’assistance Tableau (http://www.tableau.com/fr-fr/support/request(Le lien s’ouvre dans une nouvelle fenêtre)) et incluez le fichier <machine_name>-LicResults.txt que vous avez créé.

Installation de tabcmd séparément

tabcmd est automatiquement installé sur le nœud Tableau Serveur initial lorsque vous installez Tableau Server. Par contre, si vous voulez l’exécuter sur un autre ordinateur, vous devez télécharger et installer tabcmd séparément. Pour plus d’informations, consultez Installer tabcmd.

Problèmes d’installation de tabcmd sur Linux

tabcmd nécessite Java 11 pour fonctionner correctement. Sur les systèmes de type RHEL, il sera installé comme une dépendance lorsque vous installerez tabcmd. Sur les systèmes de type Debian, vous devez installer Java 11 séparément s’il n’est pas déjà installé.

Depuis juillet 2022, les distributions Debian ne sont plus prises en charge. Pour plus d’informations, consultez ce billet de la Communauté Tableau(Le lien s’ouvre dans une nouvelle fenêtre).

Java n’est pas installé

Si vous voyez des erreurs du type suivant lors de l’installation de tabcmd, vérifiez que Java 11 est installé sur votre ordinateur Linux :

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

La version incorrecte de Java est installée

Si vous voyez des erreurs du type suivant, vérifiez que Java 11 est installé :

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

ou

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.