Installer Tableau Server avec une passerelle indépendante

Cette rubrique vous guide tout au long du processus d’installation de la passerelle indépendante Tableau Server.

Suivre ce processus aboutit à une configuration de la passerelle indépendante avec une connexion directe au déploiement principal de Tableau Server. Pour en savoir plus sur les modes de connexion directe et relais, consultez la rubrique Configurer Tableau Server avec une passerelle indépendante.

Conditions préalables

  • Vous devez disposer d’un serveur dédié avec au moins 2 cœurs (4 processeurs virtuels), 8 Go de RAM et 100 Go d’espace disque libre.
  • Vous devez utiliser Tableau Server 2022.1 ou version ultérieure.
  • Vous devez utiliser un programme d’installation pour la passerelle indépendante Tableau Server avec une version majeure (2022.1, par exemple) qui correspond à la version de Tableau Server. Nous recommandons que les versions de maintenance (2022.1.1 ou 2022.1.5, par exemple) correspondent également, mais ce n’est pas une exigence. Si des « éléments statiques » changent entre les versions et que les versions ne correspondent pas, vous pourriez constater un impact inattendu sur l’image. Par exemple, les cartes peuvent ne pas être à jour si la passerelle indépendante est une version antérieure à Tableau Server.
  • Vous devez posséder une licence Advanced Management valide activée dans Tableau Server. Pour en savoir plus sur Advanced Management, consultez À propos de Tableau Advanced Management sur Tableau Server.
  • Par défaut, la passerelle indépendante doit pouvoir communiquer avec le déploiement principal de Tableau Server sur les ports 80 et 21319 lors de l’installation. Vous pouvez modifier ces ports par défaut lors de l’initialisation, comme décrit plus loin dans cette rubrique.
  • Vérifiez que votre déploiement Tableau Server est complet et sain avant d’installer et de configurer la passerelle indépendante.
  • Vérifiez que vous n’exécutez aucune autre application Web sur l’ordinateur sur lequel vous installez la passerelle indépendante. Par exemple, si Apache httpd est installé sur l’ordinateur, désinstallez-le ou configurez httpd afin qu’il n’écoute pas activement sur le port 80.

Installer Tableau Server et la passerelle indépendante

L’installation de la passerelle indépendante s’effectue à l’aide d’un module d’installation autonome qui inclut « tsig » dans le nom du fichier pour le distinguer du programme d’installation complet de Tableau Server. Nous vous recommandons vivement d’installer la passerelle indépendante après avoir installé Tableau Server et confirmé qu’il fonctionne comme prévu. Pour procéder à l’installation, vous devez avoir des droits d’administrateur . Vous pouvez installer une ou plusieurs instances de la passerelle indépendante, mais chaque instance doit être installée séparément. Si vous installez plusieurs instances pour une haute disponibilité ou pour répartir une charge client importante, répétez les étapes d’installation pour chaque instance.

Lors de l’installation, le script initialize-tsig.bat est exécuté. Ce script vous demande les informations nécessaires pour configurer la passerelle indépendante. Une fois la passerelle indépendante entièrement installée, vous devez exécuter une commande TSM sur le nœud initial de Tableau Server pour configurer le serveur avec des détails sur l’instance de la passerelle indépendante.

L’installation de la passerelle indépendante comprend ces étapes :

  • Exécuter le programme d’installation spécifique de la plate-forme.

  • Exécuter le script de post-installation. Cette opération est effectuée automatiquement par le programme d’installation.

  • Activer l’instance de la passerelle indépendante à l’aide de TSM.

Étape 1 : Télécharger et installer Tableau Server

  1. Installer TSM suivez les instructions fournies dans cette rubrique et suivez les étapes 1 à 5 pour exécuter le programme d’installation et installer TSM.

  2. Activer et enregistrer Tableau Server : fournissez la clé Tableau Server et la clé Advanced Management dans l’étape d’activation. Vous devrez exécuter la commande suivante deux fois, d’abord avec la clé produit Tableau Server et ensuite avec la clé produit Advanced Management :

    tsm licenses activate -k <product key>

  3. Configurer les paramètres du nœud initial suivez les instructions fournies dans la rubrique pour configurer les paramètres du nœud initial.

Étape 2 : Télécharger et installer la passerelle indépendante

Une fois que vous avez téléchargé le fichier d’installation de la passerelle indépendante Tableau Server, suivez les instructions ci-dessous pour procéder à l’installation de la passerelle indépendante.

  1. Sur l’ordinateur sur lequel vous installez la passerelle indépendante, connectez-vous en tant qu’utilisateur disposant d’un accès administrateur et double-cliquez sur le fichier d’installation téléchargé.

  2. Sur le premier écran, vous devez accepter le contrat de licence avant de continuer.

  3. Après acceptation du contrat de licence, vous pouvez effectuer l’une des deux actions suivantes :

    • Installer la passerelle indépendante en cliquant sur Installer
      ou
    • Modifier l’emplacement d’installation en cliquant sur Personnaliser, puis installer la passerelle indépendante :

      Par défaut, la passerelle indépendante est installée dans C:\Program Files\Tableau\Tableau Server\independentgateway. Vous pouvez choisir un emplacement différent de l’emplacement par défaut, notamment un lecteur différent, en accédant à l’emplacement souhaité ou en saisissant un nouveau chemin.

      Une fois que vous avez spécifié l’emplacement d’installation, cliquez sur Installer pour installer la passerelle indépendante à cet emplacement.

  4. Le programme d’installation installe la passerelle indépendante et exécute automatiquement le scénario initialize-tsig.bat.

    Dans une fenêtre de commande ouverte par le programme d’installation, vous êtes invité à saisir les valeurs utilisées pour configurer la passerelle indépendante :

    • TSIG_TS_CLUSTER—Obligatoire. Il n’y a pas de valeur par défaut. Vous devez entrer une valeur lorsque vous y êtes invité.

      Cette valeur doit être l’adresse ou les adresses Internet de chaque nœud du groupement Tableau Server. Des caractères génériques peuvent être utilisés et des masques de sous-réseau peuvent être utilisés pour spécifier plusieurs nœuds. Pour spécifier plusieurs adresses, séparez-les par des espaces. Les valeurs doivent être fournies dans l’une des formes acceptables pour la directive Apache httpd mod_authz_host « Require ». Pour plus d’informations, consultez https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(Le lien s’ouvre dans une nouvelle fenêtre).

    • TSIG_HK_PORT : la valeur par défaut est 21319. Il s’agit du port utilisé pour les demandes de maintenance entrantes de Tableau Server.
    • TSIG_HK_PROTOCOL : la valeur par défaut est http. Les valeurs valides sont http et https. Il s’agit du protocole utilisé pour les demandes de maintenance de Tableau Server.
    • TSIG_PORT : la valeur par défaut est 80. Le port utilisé pour les requêtes externes.
    • TSIG_PROTOCOL : la valeur par défaut est http. Les valeurs valides sont http et https. Il s’agit du protocole utilisé pour les requêtes externes.
    • TSIG_INSTANCE_ID : la valeur par défaut est le nom de la machine. Un identifiant unique pour l’instance de la passerelle indépendante.
  5. L’installation se termine lorsque l’exécution du script est terminée et que la passerelle indépendante est initialisée.

Étape 3 : Activer la passerelle indépendante dans Tableau Server

La dernière étape de l’installation et de la configuration d’Independent Gateway consiste à activer la passerelle indépendante dans Tableau Server. Pour ce faire, utilisez la commande TSM tsm topology external-services gateway enable -c <file> avec un fichier JSON qui identifie l’instance ou les instances de la passerelle indépendante et fournit à Tableau Server les détails nécessaires à la communication entre le serveur et la passerelle indépendante.

Tableau Server doit être dans un état arrêté pour activer la passerelle indépendante.

Contenu du fichier JSON de la passerelle indépendante

Le fichier JSON que vous utilisez pour activer les instances de la passerelle indépendante sur Tableau Server doit contenir les éléments suivants :

  • id : la valeur id doit correspondre à TSIG_INSTANCE_ID pour l’instance particulière. Si vous ne l’avez pas fournie lors de l’initialisation, la valeur par défaut est le nom de machine (%COMPUTERNAME%) de l’ordinateur de la passerelle indépendante. La valeur dans le fichier json doit correspondre à la sortie de la commande hostname.
  • host : l’hôte doit être un nom résoluble par DNS de l’ordinateur de la passerelle indépendante.
  • port : le port doit correspondre à la valeur TSIG_HK_PORT spécifiée sur l’instance de la passerelle indépendante. Si vous ne l’avez pas fournie lors de l’initialisation, la valeur par défaut est « 21319 ».
  • protocol : le protocole doit correspondre au protocole TSIG_HK_PROTOCOL spécifié sur l’instance de la passerelle indépendante. Si vous ne l’avez pas fournie lors de l’initialisation, la valeur par défaut est « http ».
  • Authsecret : le secret d’authentification doit correspondre au secret créé par le script d’initialisation sur l’instance de la passerelle indépendante.

Le secret d’authentification de la passerelle indépendante

Le script d’initialisation crée un secret partagé unique sur chaque ordinateur de la passerelle indépendante. Vous avez besoin de ce secret pour activer la passerelle indépendante dans Tableau Server. Copiez le secret et incluez-le dans votre fichier JSON en tant que « authsecret ».

Le secret partagé se trouve dans le fichier tsighk-auth.conf ici :

C:\ProgramData\Tableau\Tableau Server\independentgateway\config\tsighk-auth.conf

Exemple de fichier JSON de la passerelle indépendante

Le fichier JSON doit être au format ci-dessous. Cet exemple de fichier JSON affiche valeurs par défaut où elles sont utilisées. Votre fichier doit avoir utilisé les valeurs réelles qui correspondent à votre installation de la passerelle indépendante et à votre organisation.

{
"independentGateways": [ { "id": "<IGCOMPUTER>", "host": "<DNS name of Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret01>" }, { "id": "<IGCOMPUTER2>", "host": "<DNS name of second Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret02>" } ] }

Activation de la passerelle indépendante dans Tableau Server

Pour terminer l’installation de la passerelle indépendante, vous devez l’activer à l’aide de TSM.

  1. Copiez le fichier de configuration JSON sur le nœud initial de Tableau Server.
  2. Sur le nœud initial, ouvrez une invite de commande en tant qu’administrateur.
  3. Exécutez les commandes suivantes pour arrêter Tableau Server, activer la passerelle indépendante à l’aide du fichier de configuration json et redémarrer le serveur :

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

Étape 4 : Vérifier la passerelle indépendante dans Tableau Server

Vous devriez pouvoir accéder à la page de connexion de Tableau Server en saisissant l’adresse de la passerelle indépendante dans un navigateur.

S’il existe un pare-feu entre la passerelle indépendante et le déploiement principal de Tableau Server, vous devrez alors ouvrir les ports pour les processus Tableau Server pour établir une connexion directe. Pour plus d’informations, consultez Connexion en direct.

Vous pouvez également choisir de minimiser les exigences de port en configurant la passerelle indépendante pour une connexion relais. Pour plus d’informations, consultez Connexion par relais.

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