Aide de Tableau Server sur Linux

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.

• Activez l’instance Independent Gateway à l’aide de TSM.

Installez Tableau Server Independent Gateway avec le gestionnaire de package de votre distribution, puis exécutez un script pour initialiser Independent Gateway. Le script est inclus avec le package installé.

La passerelle indépendante est installée dans le répertoire /opt.

1. Connectez-vous en tant qu’utilisateur doté d’un accès sudo à l’ordinateur sur lequel vous souhaitez installer Independent Gateway.

   Remarque : pour éviter d’éventuelles complications, nous vous recommandons un compte utilisateur qui n’inclut aucun caractère spécial (par exemple, non-ASCII, « + », « - »). Ceux-ci peuvent causer des problèmes, notamment l’échec de l’installation complète d’Independent Gateway, selon la configuration de votre environnement.

2. Téléchargez le package du programme d’installation .rpm ou .deb depuis la page Téléchargements et notes de version de Tableau Server.

3. Accédez au répertoire sur lequel vous avez copié le package .rpm ou .deb.

4. Utilisez le gestionnaire de package pour installer le package Independent Gateway.

   N’effectuez pas l’installation dans un emplacement utilisant un lien symbolique ou dans un répertoire d’un volume Network File System (NFS). Exécutez les commandes suivantes pour installer lndependent Gateway, où <version> utilise le format major-minor-maintenance (exemple : 2022-1-0).

   • Pour les distributions de type RHEL, y compris CentOS :

     sudo yum update

     sudo yum install tableau-tsig-<version>.x86_64.rpm

   • Sur Ubuntu :

     sudo apt-get update
     sudo apt-get upgrade
     sudo apt-get -y install gdebi-core
     sudo gdebi -n tableau-tsig-<version>_amd64.deb
     

Initialiser Tableau Server Independent Gateway

L’étape suivante consiste à lancer le script initialize-tsig.

1. Accédez au répertoire scripts :

   cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/

2. Exécutez le script suivant pour initialiser et démarrer Independent Gateway :

   sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>

   Les seuls paramètres requis pour le script initialize-tsig sont --accepteula et -c.

   • --accepteula - Vous devez inclure ce paramètre pour accepter le contrat de licence de l’utilisateur final (CLUF) Tableau Server. Un lien vers le CLUF est disponible à l’emplacement suivant :

     /opt/tableau/tableau_tsig/packages/docs.<version_code>/

   • -c - Vous devez inclure ce paramètre pour spécifier l’emplacement réseau de tous les nœuds du cluster Tableau Server. Ces nœuds peuvent envoyer des demandes de "maintenance" à Independent Gateway. Les caractères génériques et les 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 et utilisez des guillemets autour de l’ensemble complet. 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).

   Tous les autres paramètres, par exemple les ports par défaut utilisés par HTTP et le processus de maintenance, sont facultatifs et s’ils ne sont pas définis, ils recevront des valeurs par défaut. Vérifiez les paramètres et leurs valeurs par défaut avant d’exécuter le script : Résultat de l’aide pour le script initialize-tsig.

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 de l’identifiant doit correspondre à tsig_instance_id pour le cas particulier. Si vous ne l’avez pas fourni, la valeur par défaut est le nom de domaine qualifié complet de l’ordinateur Independent Gateway, en lettres minuscules. La valeur dans le fichier json doit correspondre à la sortie de la commande hostname.
• host : la valeur de l’hôte doit être un nom pouvant être résolu par le DNS pour l’ordinateur Independent Gateway qui peut être résolu par les nœuds Tableau Server utilisant DNS.
• port : le port doit correspondre au port de maintenance (tsig_housekeeping_port ) spécifié 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 être identique au protocole de maintenance interne (tsig_housekeeping_port_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 :

/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf

Activation d’Independent Gateway dans Tableau Server

Pour terminer l’installation d’Independent Gateway, 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 avec un compte membre du groupe tsmadmin.

3. 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