Aide de Tableau Server sur Windows

Pour installer et configurer l’Agent :

1. Téléchargez le fichier bootstrap et enregistrez-le à un emplacement accessible depuis les nœuds Tableau Server.

   rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

2. Exécutez le programme d’installation de l’Agent :

   1. Téléchargez le programme d’installation de l’Agent et enregistrez-le à un emplacement où vous pouvez accéder depuis les ordinateurs Tableau Server.

   2. Ouvrez l’invite de commande en tant qu’administrateur.

   3. Accédez à l’emplacement du programme d’installation de l’Agent et exécutez le fichier exe à l’aide de la commande suivante :

      Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>

      À partir de la version 2021.4, vous devez spécifier un compte Exécuter en tant qu’utilisateur pour l’agent. Ce compte est utilisé pour accéder à Tableau Server afin de recueillir des informations de surveillance.

      Pour le compte Exécuter en tant qu’utilisateur, spécifiez le même compte que vous utilisez actuellement pour le compte d’utilisateur de Tableau Server. Si les informations de compte que vous fournissez ne sont pas les mêmes que celles de Tableau Server, l’agent ne pourra pas collecter les données de surveillance sur ce nœud.

      • Utilisez RUN_AS_NETWORK_SERVICE=1 si votre Tableau Server est configuré pour utiliser le compte de service réseau en tant qu’utilisateur Exécuter en tant qu’utilisateur.
      • Utilisez RUN_AS_USER_CUSTOM=1 si votre Tableau Server est configuré pour utiliser un utilisateur personnalisé. Utilisez les mêmes informations d’identification de compte que celles spécifiées pour Tableau Server.

      L’emplacement par défaut est généralement : C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent. Pour fournir un emplacement d’installation différent, exécutez la commande suivante :

      Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

      Remarque : utilisez le commutateur /silent ou /quiet pour exécuter l’installation sans surveillance et sans afficher d’interface utilisateur ou d’invites.

3. Enregistrez l’Agent :

   1. Exécutez la commande suivante pour enregistrer l’Agent :

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>

      Le tableau suivant énumère les options de configuration utilisées pour enregistrer l’Agent :

      Option	Obligatoire?	Par défaut	Description
      Fichier --bootstrap	Oui	<none>	Emplacement du fichier de bootstrap.
      --username	Oui	<none>	Il s’agit généralement de l’utilisateur administrateur que vous avez créé lors de l’installation du Serveur RMT.
      --password	Oui	<none>	C’est le mot de passe du compte utilisateur
      --password-file	Non Le mot de passe peut être inclus dans la ligne de commande ou dans un fichier contenant le mot de passe. Si aucun des deux n’est fourni, vous serez invité à saisir un mot de passe.	<none>	Chemin d’accès comprenant le nom du fichier où le mot de passe est stocké.
      --server-name	Non	Nom d’hôte de la machine	Nom de l’ordinateur sur lequel l’Agent est installé. Si aucune option n’est fournie, ce champ sera par défaut le nom d’hôte de la machine.
      --server-description	Non	<none>	Description de l’ordinateur sur lequel l’Agent est installé. Si aucune option n’est fournie, ce champ reste vide.

      Propriétés et commutateurs d’installation Windows

      Commutateurs :

      Commutateur	Description	Commentaires
      /passive	Exécutez le programme d’installation avec un minimum d’interface utilisateur et aucune invite.
      /quiet | /silent	Exécutez le programme d’installation en mode automatisé complètement silencieux. Aucune interface Web ou invite n’est affichée.	Utilisez soit /quiet, soit /silent, mais pas les deux.

      Propriétés :

      Propriété	Description	Commentaires
      InstallFolder=<path\to\installation\directory>	Installez sur un emplacement d’installation autre que par défaut.	Spécifie l’emplacement d’installation de RMT. S’il n’est pas utilisé, RMT est installé sur C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master. Exemple : <Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"
      ACCEPTEULA=1|0	Acceptez le contrat de licence de l’utilisateur final (CLUF). Requis pour l’installation calme, silencieuse et passive à la fois sur le nœud initial et les nœuds supplémentaires. 1 = vrai, accepter le CLUF, 0 = faux, ne pas accepter le CLUF.	S’il n’est pas inclus lorsque vous utilisez /passive, /silent ou /quiet, l’installation échoue en silence. S’il est inclus mais défini sur 0, l’installation échoue.

       

Pour installer et configurer l’Agent :

1. Installation :

   1. Téléchargez le programme d’installation .rpm ou .deb de l’Agent et enregistrez-le à un emplacement auquel vous pouvez accéder depuis l’ordinateur sur lequel vous prévoyez d’installer l’Agent.

   2. Exécutez la commande suivante pour installer l’Agent, où <version> utilise le format majeur-mineur-maintenance :

      Pour les distributions de type RHEL, y compris CentOS :

      sudo yum install Tabrmt-Agent-x86_64-<version>.rpm

      Pour Ubuntu :

      sudo apt install Tabrmt-Agent-amd64-<version>.deb

2. Initialiser l’agent RMT :

   Vous devez explicitement accepter le contrat de licence de l’utilisateur final (CLUF) lorsque vous initialisez l’agent RMT. Vous avez également la possibilité de spécifier des configurations autres que les configurations par défaut. Pour initialiser l’agent RMT avec une configuration par défaut, exécutez cette commande :

   sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula

   Le CLUF se trouve dans le dossier /opt/tableau/tabrmt/agent/docs.

   À compter de la version 2023.1, vous pouvez spécifier un compte personnalisé Exécuter en tant que destiné à être utilisé par RMT, ainsi que d’autres options de configuration. Par défaut, RMT crée et utilise un compte appelé rmt-agent sous lequel il sera exécuté. Pour spécifier un compte personnalisé Exécuter en tant que destiné à être utilisé par l’agent RMT, incluez l’option --unprivileged-user lorsque vous exécutez le script d’initialisation. Pour en savoir plus sur tous les commutateurs disponibles pour le script initialize-rmt-agent, consultez les Options de script d’initialisation de l’agent RMT.

3. Enregistrement :

   1. Déconnectez-vous puis connectez-vous en tant qu’utilisateur tabrmt-agent afin de pouvoir exécuter les commandes rtmadmin qui exigent toujours l’exécution en tant qu’utilisateur tabrmt-agent. De plus, lorsque vous vous reconnecterez, vous créerez une nouvelle session dans laquelle les modifications apportées aux membres du groupe auront pris effet.

      sudo su --login tabrmt-agent

   2. Exécutez la commande suivante et indiquez le chemin où se trouve le fichier bootstrap. Fournissez un nom convivial ainsi qu’une description du nœud où l’agent est installé.

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --agent-description=<server description> --username=<name of the RMT admin user>

      Le mot de passe de l’utilisateur administratif RMT vous sera demandé.

      Remarque : l’utilisateur tabrmt-agent exécute par défaut les commandes depuis le répertoire actif de base : /var/opt/tableau/tabrmt/agent. Vous devez donc spécifier le chemin de fichier complet en conséquence. Par exemple, si vous avez placé le fichier bootstrap dans le dossier /var/opt/tableau/tabrmt/agent/bootstrap/folder tel que recommandé, le chemin de fichier serait /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.json

      Le tableau suivant énumère les options de configuration utilisées pour enregistrer l’Agent :

      Option	Obligatoire?	Par défaut	Description
      Fichier --bootstrap	Oui	<none>	Emplacement du fichier de bootstrap.
      --username	Oui	<none>	Il s’agit généralement de l’utilisateur administrateur que vous avez créé lors de l’installation du Serveur RMT.
      --password	Oui	<none>	C’est le mot de passe du compte utilisateur
      	Non Le mot de passe peut être inclus dans la ligne de commande ou dans un fichier contenant le mot de passe. Si aucun des deux n’est fourni, vous serez invité à saisir un mot de passe.	<none>	Chemin d’accès comprenant le nom du fichier où le mot de passe est stocké.
      --server-name	Non	Nom d’hôte de la machine	Nom de l’ordinateur sur lequel l’Agent est installé. Si aucune option n’est fournie, ce champ sera par défaut le nom d’hôte de la machine.
      --server-description	Non	<none>	Description de l’ordinateur sur lequel l’Agent est installé. Si aucune option n’est fournie, ce champ reste vide.