Aide de Tableau Server sur Linux

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

Le fichier 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 sur 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érieure 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 la 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 fichiers 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 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 identifiants que vous avez saisis ne sont pas valides, ou vous avez fait une 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 fichiers 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 la version 2022,1 et les 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 :

« Impossible de restaurer la sauvegarde 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 de celui que la sauvegarde utilise. Pour résoudre ce problème, consultez Résoudre les problèmes liés à la migration des identités.

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 fichiers 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 fichiers 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 Fichiers 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

Dans 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 échoue et affiche l’erreur « Impossible de lire le fichier de sauvegarde ou de restaurer le référentiel ».

Depuis la version 2022.1, le script de mise à niveau confirme les autorisations de l’emplacement du fichier de sauvegarde/restauration avant de lancer la mise à niveau. De cette manière, le fichier pourra être enregistré et lu depuis l’emplacement pendant la mise à niveau vers la nouvelle version de Tableau Server.

Les erreurs seront du type suivant :

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. Sa valeur est définie par défaut avec les autorisations appropriées par le programme d’installation, mais celles-ci peuvent être affectées par les règles informatiques de l’entreprise, ou si vous modifiez l’emplacement vers un emplacement que vous avez créé vous-même. La version 2022.1 propose une nouvelle commande qui permet de vérifier les autorisations sur l’emplacement du fichier de sauvegarde/restauration immédiatement après sa création, de manière à éviter les problèmes d’autorisation. 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 au fichier de sauvegarde/restauration, consultez Chemins d’accès des fichiers tsm.

Réussite de la mise à niveau, mais impossible d’accéder aux sources de données publiées

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 pourrait arriver si :

1. Vous mettez à niveau une installation de Tableau Server qui était la version 2021.3.x à tout moment (vous pouvez exécuter la version 2021.3 ou avoir effectué une mise à niveau de la version 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 situations suivantes :

• Dans tous les autres chemins de mise à niveau à partir de 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 ultérieures, ou 2023.3.9 ou ultérieures.

Pour plus d’informations à ce sujet, consultez Known Issues(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 d’octroi de licences de Tableau a déménagé vers un nouveau centre de données. Cela signifie que tous les environnements qui exigeaient une configuration spéciale (liste autorisée 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 aux domaines ocsp.*.amazontrust.com et crl.*.amazontrust.com sont gérées par Amazon pour les informations de révocation de certificat. Consultez Charactéristiques des certificats TLS(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 confiance des certificats sur l’ordinateur qui exécute Tableau. Pour télécharger et installer les certificats racines Amazon, consultez Certification Authorities(Le lien s’ouvre dans une nouvelle fenêtre) sur le site Web 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 fichier 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 données de la 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. Communiquez avec l’assistance Tableau (http://www.tableau.com/fr-ca/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 a besoin de 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 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.