Résolution des problèmes de la passerelle indépendante Tableau Server

Cette rubrique vous guide tout au long du processus d’installation de la passerelle indépendante Tableau Server. Le processus décrit dans cette rubrique est identique toutes les mises à niveau de version. Cela signifie que vous pouvez utiliser ce processus pour les mises à niveau de version majeure (par exemple, 2022.1 à 2023.1) et de version de maintenance (2022.1.1 à 2023.1.1).

Vous devez utiliser un programme d’installation de la passerelle indépendante Tableau Server avec une version majeure qui correspond à la version de Tableau Server. Nous recommandons que les versions de maintenance (2022.1.1 ou 2022.1.2 par exemple) correspondent également, mais ce n’est pas une exigence. Si les « ressources statiques » changent entre les versions et que les versions ne correspondent pas, vous verrez peut-être un impact inattendu sur l’image. Par exemple, les cartes peuvent ne pas être à jour si la version de la passerelle indépendante est plus ancienne que Tableau Server.

Présentation

Le processus de mise à niveau de la passerelle indépendante est en fait un processus de désinstallation puis de réinstallation du logiciel. Vous pouvez toutefois minimiser la configuration et le temps d’arrêt global en suivant le processus décrit dans la présente rubrique.

Le processus décrit ici suppose que vous disposez d’un déploiement fonctionnel de Tableau Server et de la passerelle indépendante Tableau Server en cours d’exécution. Si vous mettez à niveau le déploiement principal de Tableau Server dans le cadre de votre mise à niveau, nous vous recommandons de commencer par mettre à niveau le(s) serveur(s) de passerelle indépendante, en validant la connectivité de base avec un client Tableau, puis en procédant à la mise à niveau de Tableau Server.

Les étapes détaillées dans cette rubrique sont résumées ici :

  1. Copiez certains fichiers existants à utiliser lors de la mise à niveau.
  2. Exécutez le script obliterate pour supprimer la passerelle indépendante.
  3. Installez la nouvelle version de la passerelle indépendante.
  4. Facultatif : remplacez le fichier tsighk-auth par la copie d’origine.
  5. Mettez à jour les paramètres TLS.
  6. Facultatif : mettez à jour le serveur principal de Tableau Server
  7. Redémarrez le service de passerelle indépendante.

Étape 1 : Copier les fichiers pour référence

Vous devrez peut-être faire référence aux paramètres de configuration stockés dans les fichiers suivants. Copiez ces fichiers dans un emplacement sécurisé et accessible (les chemins d’accès aux fichiers sont l’emplacement par défaut) :

  • ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf
  • ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub
  • ProgramData\Tableau\tableau_tsig\config\environment.bash

Étape 2 : Effacer la passerelle indépendante

Pour supprimer la passerelle indépendante du ou des serveurs, exécutez le script tableau-tsig-obliterate.cmd :

  1. Sur le nœud initial, ouvrez une invite de commande en tant qu’administrateur.

  2. Exécutez le script tableau-tsig-obliterate.cmd :

    C:\Program Files\Tableau\tableau_tsig\packages\scripts.<version_code>\tableau-tsig-obliterate.cmd -y -y -y

  3. Redémarrez l’ordinateur.

Étape 3 : Installer la passerelle indépendante

Téléchargez la version de la passerelle indépendante vers laquelle vous souhaitez effectuer la mise à niveau, puis suivez la même procédure d’installation que celle décrite dans la rubrique Installer Tableau Server avec Independent Gateway.

Comme pour l’installation d’origine, vous devrez spécifier les paramètres d’initialisation dans le cadre de la configuration. Pour utiliser les mêmes valeurs, référencez le fichier enviornment.bash que vous avez copié à l’étape 1. N’écrasez pas le nouveau fichier bash avec l’original.

Étape 4 : (Facultatif) Remplacer le fichier tsighk-auth par la copie d’origine

Le fichier tsighk-auth est un fichier de configuration qui stocke une chaîne unique appelée authsecret. La chaîne authsecret est utilisée pour vérifier que le serveur principal Tableau Server communique avec une instance approuvée de la passerelle indépendante. Lorsque vous avez configuré l’instance d’origine de la passerelle indépendante, vous avez dû mettre à jour un fichier de configuration sur le serveur principal Tableau Server avec la chaîne authsecret.

Si votre politique de sécurité le permet, vous pouvez continuer à utiliser la chaîne authsecret d’origine sur la passerelle indépendante. Vous éviterez ainsi de devoir mettre à jour et redémarrer le serveur principal Tableau Server avec une nouvelle chaîne authsecret.

Pour conserver la chaîne authsecret d’origine, remplacez le fichier tsighk-auth.conf (dans ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf) par la copie que vous avez enregistrée à l’étape 1.

Si votre stratégie de sécurité exige que vous actualisiez la chaîne authsecret, notez la nouvelle chaîne authsecret qui a été générée par le processus d’installation. Vous mettrez à jour le serveur principal Tableau Server avec le nouvelle chaîne authsecret plus tard dans le processus.

Étape 5 : Mettre à jour les paramètres TLS de maintenance

Si vous n’avez pas configuré TLS pour la communication interne (HK) entre la ou les instances de passerelle indépendante et le déploiement principal de Tableau Server, vous pouvez ignorer cette étape.

Si vous avez configuré HK TLS, vous devez copier manuellement la configuration depuis le fichier original httpd.conf.stub dans le fichier qui se trouve dans ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub. Ne remplacez pas le nouveau fichier par le fichier d’origine, car le nouveau fichier peut inclure d’autres paramètres.

  1. Mettez à jour les paramètres de configuration TLS pertinents dans le bloc suivant :

    <VirtualHost *:${TSIG_HK_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>

    Pour plus d’informations sur ces paramètres, consultez Configurer TLS sur la passerelle indépendante.

  2. Lorsque vous avez terminé la mise à jour de httpd.conf.stub , enregistrez le fichier.

  3. Copiez httpd.conf.stub puis enregistrez pour remplacer httpd.conf dans le même répertoire.

Étape 6 : (Facultatif) Mettre à jour le déploiement principal de Tableau Server

Si vous avez copié le fichier authsecret d’origine (tsighk-auth.conf ) sur la nouvelle instance de la passerelle indépendante comme décrit à l’étape 4, vous pouvez ignorer cette étape.

Si vous actualisez la chaîne authsecret dans le déploiement principal de Tableau Server, vous devez mettre à jour le fichier tsig.json sur le nœud initial avec la nouvelle chaîne authsecret. Consultez Installer Tableau Server avec Independent Gateway Une fois que vous avez terminé, exécutez les commandes TSM suivantes :

tsm stop
tsm topology external-services gateway update -c tsig.json
tsm start

Étape 7 : Redémarrer le service tsig-httpd

Lorsque vous avez terminé la configuration. redémarrez le service tsig-httpd.