Installer Tableau Server avec Independent Gateway

S’applique à : Tableau Advanced Management

Cette rubrique vous guide tout au long du processus d’installation de Tableau Server Independent Gateway.

L’application de ce processus aboutira à une configuration de passerelle indépendante avec une connexion directe au déploiement principal de Tableau Server. Vous pouvez en savoir plus sur les modes de connexion direct et relais dans la rubrique Configurer Tableau Server avec Independent Gateway.

Conditions préalables

Vous devez disposer d’un serveur dédié avec au moins 2 cœurs (4 vCPU), 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 Tableau Server Independent Gateway 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 obligation. 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 Independent Gateway est à une version plus ancienne que Tableau Server.
Vous devez avoir 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, Independent Gateway 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 Independent Gateway.
Vérifiez que vous n’exécutez aucune autre application Web sur l’ordinateur sur lequel vous installez Independent Gateway. 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 Independent Gateway

L’installation d’Independent Gateway s’effectue à l’aide d’un programme de 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 Independent Gateway après avoir installé Tableau Server et vérifié qu’il fonctionne comme prévu. Pour installer, vous devez avoir des droits d’administrateur. Vous pouvez installer une ou plusieurs instances d’Independent Gateway, mais chaque instance d’Independent Gateway doit être installée séparément. Si vous installez plusieurs instances pour assurer la haute disponibilité ou pour répartir une charge client importante, répétez les étapes d’installation pour chaque instance.

Lors de l’installation, un script appelé initialize-tsig.bat est exécuté. Le script vous demande les informations nécessaires pour configurer Independent Gateway. Après l’installation complète d’Independent Gateway, vous devez exécuter une commande TSM sur le nœud initial Tableau Server pour configurer le serveur avec des détails sur l’instance Independent Gateway.

L’installation d’IG comprend ces étapes :

Exécutez le programme d’installation spécifique à la plate-forme.
Exécutez le script de post-installation. Cette opération est effectuée automatiquement par le programme d’installation.
Activez l’instance Independent Gateway à l’aide de TSM.

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

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.
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>
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 Independent Gateway

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

Sur l’ordinateur sur lequel vous installez Independent Gateway, connectez-vous en tant qu’utilisateur disposant d’un accès administrateur et double-cliquez sur le fichier d’installation téléchargé.
Sur le premier écran, vous devez accepter le contrat de licence avant de continuer.
Après avoir accepté le contrat de licence, vous pouvez effectuer l’une des deux actions suivantes :
- Installez Independent Gateway en cliquant sur Installer
  ou
- Modifiez l’emplacement d’installation en cliquant sur Personnaliser, puis installez Independent Gateway :
  Par défaut, Independent Gateway est installé sur C:\Program Files\Tableau\Tableau Server\independentgateway. Vous pouvez choisir un emplacement autre que par défaut, y compris un lecteur différent, soit en accédant à l’emplacement soit en saisissant un nouveau chemin.
  Une fois que vous avez spécifié l’emplacement d’installation, cliquez sur Installer pour installer la Independent Gateway à cet emplacement.
Le programme d’installation installe Independent Gateway et exécute automatiquement le script 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 Independent Gateway :
- TSIG_TS_CLUSTER - Obligatoire. Il n’y a aucune valeur par défaut. Vous devez entrer une valeur lorsque vous y êtes invité.
  Il doit s’agir de l’adresse ou des adresses Internet de chaque nœud du cluster 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 adresses par des espaces. Les valeurs doivent être indiquées 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 demandes 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 demandes externes.
- TSIG_INSTANCE_ID - La valeur par défaut est le nom de la machine. Un identifiant unique pour l’instance Independent Gateway.
L’installation se termine lorsque l’exécution du script est terminée et qu’Independent Gateway est initialisé.

Étape 3 : Activer Independent Gateway dans Tableau Server

La dernière étape de l’installation et de la configuration d’Independent Gateway consiste à activer Independent Gateway 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 Independent Gateway et fournit à Tableau Server les détails nécessaires à la communication entre le serveur et Independent Gateway.

Tableau Server doit être dans un état arrêté pour activer Independent Gateway.

Contenu du fichier JSON d’Independent Gateway

Le fichier JSON que vous utilisez pour activer les instances Independent Gateway sur Tableau Server doit contenir les éléments suivants :

id : la valeur d’identifiant doit correspondre au 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 Independent Gateway La valeur dans le fichier json doit correspondre à la sortie de la commande hostname.
host : l’hôte doit être un nom pouvant être résolu par DNS sur l’ordinateur Independent Gateway.
port : le port doit correspondre à la valeur TSIG_HK_PORT spécifiée sur l’instance Independent Gateway. Si vous ne l’avez pas fournie lors de l’initialisation, la valeur par défaut est "21319".
protocol : le protocole doit correspondre au TSIG_HK_PROTOCOL spécifié sur l’instance Independent Gateway. 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 Independent Gateway.

Secret d’authentification Independent Gateway

Le script d’initialisation crée un secret partagé unique sur chaque ordinateur Independent Gateway. Vous avez besoin de ce secret pour activer Independent Gateway 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 Independent Gateway

Le fichier JSON doit être au format ci-dessous. Cet exemple de fichier JSON affiche les valeurs par défaut là où il y a des valeurs par défaut. Votre fichier doit avoir utilisé les valeurs réelles qui correspondent à votre installation d’Independent Gateway et à votre entreprise.

{
 "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 d’Independent Gateway dans Tableau Server

Pour terminer l’installation d’Independent Gateway, vous devez l’activer à l’aide de TSM.

Copiez le fichier de configuration JSON sur le nœud initial de Tableau Server.
Sur le nœud initial, ouvrez une invite de commande en tant qu’administrateur.
Exécutez les commandes suivantes pour arrêter Tableau Server, activer Independent Gateway à 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 Independent Gateway dans Tableau Server

Vous devriez pouvoir accéder à la page de connexion de Tableau Server en saisissant l’adresse d’Independent Gateway dans un navigateur.

S’il existe un pare-feu entre Independent Gateway et le déploiement principal de Tableau Server, vous devrez alors ouvrir les ports pour les processus Tableau Server pour une connexion directe. Voir Connexion en direct pour plus d’informations.

Sinon, vous pouvez choisir de minimiser les exigences de port en configurant Independent Gateway pour une connexion relais. Voir Connexion par relais pour plus d’informations.

Retour en haut

Merci de vos commentaires !

Avis correctement envoyé. Merci

Aide de Tableau Server sur Windows