Installer le Serveur RMT à la ligne de commande

S’applique à : Tableau Advanced Management

Le Serveur Resource Monitoring Tool (Serveur RMT) héberge l’application Web avec laquelle les utilisateurs interagissent. Il effectue également une grande partie du traitement en arrière-plan pour collationner et surveiller les données envoyées par les Agents. Vous devez installer le Serveur RMT sur un matériel dédié.

Cette rubrique décrit les étapes que vous pouvez appliquer pour installer le Serveur RMT à la ligne de commande. L’installation à la ligne de commande est prise en charge à la fois sur les systèmes d’exploitation Windows et Linux.

Nous veillons à mettre en œuvre l’une des valeurs fondamentales de notre entreprise, à savoir l’égalité, et à cette fin, nous avons modifié la terminologie afin d’être le plus inclusifs possible. Étant donné que la modification des termes à certains endroits peut entraîner un changement radical, nous conservons la terminologie existante. Il se peut donc que vous continuiez à voir les termes dans les commandes et options de l’interface en ligne de commande, dans les dossiers d’installation, dans les fichiers de configuration et dans d’autres instances. Pour plus d’informations, consultez À propos de l’Aide de Tableau(Le lien s’ouvre dans une nouvelle fenêtre).

Pour installer le Serveur RMT :

  1. Installer le Serveur RMT :

    1. Téléchargez le programme d’installation .rpm ou .deb du Serveur RMT et enregistrez-le à un emplacement auquel vous pouvez accéder depuis l’ordinateur où vous prévoyez d’installer le Serveur RMT.

    2. Connectez-vous en tant qu’utilisateur doté d’un accès sudo à l’ordinateur où vous souhaitez installer le Serveur RMT.

    3. Exécutez la commande suivante pour installer le Serveur RMT, où <version> utilise le format majeure-mineure-maintenance :

      Pour les distributions de type RHEL, y compris CentOS :

      sudo yum install <pathtormtserverinstaller>/Tabrmt-Master-x86_64-<version>.rpm

      Pour les distributions Ubuntu :

      sudo apt install ./<pathtormtserverinstaller>/Tabrmt-Master-amd_64-<version>.deb

    Cela installe le package et les prérequis, y compris RabbitMQ, Erlang, et une base de données PostgreSQL. La base de données PostgreSQL est utilisée pour stocker les données d’utilisation collectées depuis Tableau Server. Le processus se poursuit avec l’installation du Serveur RMT.

  2. Initialiser le serveur RMT :

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

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

    Le CLUF se trouve dans le dossier /opt/tableau/tabrmt/master/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-master sous lequel il sera exécuté. Pour spécifier un compte personnalisé Exécuter en tant que destiné à être utilisé par le serveur 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-master, consultez les Options de script d’initialisation du serveur RMT.

  3. Configuration du serveur RMT :

    1. Exécutez la commande suivante en tant qu’utilisateur tabrmt-master :

      sudo su --login tabrmt-master

      rmtadmin master-setup [options]

      Les options de configuration peuvent être fournies soit par l’invite de commande, soit par un fichier de configuration. Si vous ne spécifiez pas d’options, les valeurs par défaut seront appliquées à l’exception du mot de passe de l’administrateur. Le nom d’utilisateur de l’administrateur sera défini sur admin et vous serez invité à fournir le mot de passe.

      Exemple de commande incluant le paramètre de mot de passe requis :

      rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>

      Le tableau suivant répertorie les exigences et les options couramment utilisées pour configurer le Serveur RMT. Pour une liste complète des options de configuration, consultez Utilitaire de ligne de commande rmtadmin.

      Remarque : l’option Nécessite HTTPS garantit des communications sécurisées entre le Serveur RMT et les utilisateurs. Lorsque vous exigez HTTPS pour les communications, vous devez également sélectionner un mode que le certificat doit utiliser pour ces communications. Le tableau ci-dessous présente les différentes options. Pour en savoir plus sur ces modes et certificats, consultez Mode de certificat SSL et exigences.

      OptionObligatoire?

      Par défaut

      		Description
      admin-password

      Oui

      Le mot de passe peut être inclus dans la ligne de commande ou fournir un fichier avec le mot de passe à utiliser. Si aucun des deux n’est fourni, vous serez invité à saisir un mot de passe.

      		S.O.Mot de passe de l’utilisateur administrateur.
      admin-password-file

      Non

      Le mot de passe peut être inclus dans la ligne de commande ou fournir un fichier avec le mot de passe à utiliser. Si aucun des deux n’est fourni, vous serez invité à saisir un mot de passe.

      		S.O.

      Fichier où le mot de passe de l’utilisateur administrateur est stocké.

      Remarque : l’utilisateur tabrmt-master doit avoir accès à ce fichier.

      admin-usernameNonadminNom d’utilisateur de l’utilisateur administrateur.
      http-portNon80 
      require-httpsNonFalseRediriger le trafic http vers HTTPS.
      https-certificate-modeNon

      "Default"

      Options disponibles :

      Par défaut

      Local

      Type de recherche de certificat à effectuer pour le certificat HTTPS.

      Par défaut : ce mode utilise le certificat auto-signé par défaut fourni par le programme d’installation.

      Local : Ce mode vous permet de spécifier un certificat basé sur un fichier dans le dossier /var/opt/tableau/tabrmt/master/config.

      https-certificate-local-name

      Non

      Remarque : en l’absence de spécification, Resource Monitoring Tool est installé avec un certificat auto-signé et utilisera ce certificat pour les communications HTTPS.

      		NullNom du fichier de certificat HTTPS sans l’extension de fichier.
      https-certificate-local-passwordNonNullMot de passe à utiliser pour le certificat HTTPS.
      https-certificate-local-password-fileNonNullChemin du fichier contenant le mot de passe à utiliser pour le certificat HTTPS.

  4. Créer un environnement :

    1. Exécutez la commande suivante pour créer un environnement :

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      Configurez l’environnement à l’aide des options disponibles pour cette commande. Voici quelques options de configuration clés à prendre en compte :

      • L’API REST Tableau Server et les configurations du référentiel Tableau Server sont utilisées pour communiquer avec Tableau Server. La configuration du référentiel Tableau Server est facultative, mais constitue une méthode préférée pour accéder à Tableau Server.

      • Vous avez la possibilité de configurer une connexion chiffrée sécurisée lorsque RMT se connecte au référentiel Tableau Server. Afin d’utiliser les connexions SSL entre RMT et la base de données du référentiel Tableau Server, Tableau Server doit être configuré pour utiliser SSL. Pour plus d’information, consultez Configurer SSL pour la communication Postgres interne.

      Le tableau suivant répertorie certaines des options courantes. Pour voir la liste complète des options, consultez Utilitaire de ligne de commande rmtadmin.

      OptionObligatoire?Par défautDescription
      --nameOuiS.O.Nom de l’environnement.
      --gateway-url

      Oui

       

      		S.O.

      URL utilisée pour accéder à la passerelle Tableau Server.

      --versionOuiS.O.Version de Tableau Server que cet environnement surveillera.
      --api-usernameNonNullNom d’utilisateur du compte utilisé pour se connecter aux API de Tableau Server. Le compte utilisateur doit être un administrateur Tableau Server ayant accès à tous les sites Tableau Server.
      --api-password

      Non

      (Si vous spécifiez le nom d’utilisateur de l’API Tableau, vous fournirez soit le mot de passe, soit le chemin du fichier et le fichier contenant le mot de passe)

      Null

      Mot de passe du compte utilisateur de l’API Tableau Server utilisé pour se connecter aux API Tableau Server.

      --api-password-fileNonNullChemin d’accès au fichier et nom du fichier contenant le mot de passe du compte utilisateur de l’API Tableau Server.
      --repository-serverOui

      Null

      		Il s’agit du nom du serveur pour la base de données PostgreSQL qui est installée avec Tableau Server
      --repository-portOuiNullNuméro de port de la base de données du référentiel Tableau Server.
      --repository-usernameOuiNull

      Nom d’utilisateur utilisé pour la connexion à la base de données PostgreSQL installée avec le référentiel Tableau Server.

      Resource Monitoring Tool accède directement à la base de données du référentiel Tableau Server pour des raisons de performances. Pour que cela fonctionne, l’accès au référentiel doit être activé, avec un mot de passe défini pour l’utilisateur de la base de données readonly. Pour plus d’information, consultez Activer l’accès au référentiel Tableau Server.

      --repository-passwordOuiNull

      Mot de passe pour le compte utilisateur utilisé pour se connecter à la base de données PostgreSQL qui est installée avec Tableau Server.

      Resource Monitoring Tool accède directement à la base de données du référentiel Tableau Server pour des raisons de performances. Pour que cela fonctionne, l’accès au référentiel doit être activé, avec un mot de passe défini pour l’utilisateur de la base de données readonly. Pour plus d’information, consultez Activer l’accès au référentiel Tableau Server.

      --repository-password-fileNonNullChemin comprenant le nom de fichier où le mot de passe du compte utilisateur utilisé pour se connecter à la base de données PostgreSQL qui est installée avec Tableau Server.
      --repository-ssl-mode

      Non

      		Préférence

      Mode SSL du référentiel Tableau Server :

      Préférez SSL ou Exigez SSL pour configurer les connexions SSL au référentiel Tableau.

      Désactivez pour ne jamais utiliser SSL lors des connexions au référentiel Tableau Server.

      --repository-ssl-thumbprint

      Non

      		NullVous pouvez choisir soit de fournir l’empreinte digitale générée par Tableau Server, soit de copier le fichier server.crt sur l’ordinateur du serveur Resource Monitoring Tool (Serveur RMT). Si vous choisissez de copier le fichier certificat, vous n’avez pas à fournir l’empreinte digitale. Pour plus d’information, consultez Configurer Postgres SSL pour autoriser les connexions directes depuis les clients.

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

  5. Étape facultative (uniquement si vous n’utilisez pas SSD) : Resource Monitoring Toolest optimisé pour SSD par défaut. Si vous n’utilisez pas de matériel SSD, exécutez la commande :

    sudo /opt/tableau/tabrmt/master/tabrmt-master optimize --no-ssd

     

Qui peut le faire?

Pour installer Resource Monitoring Tool, vous devez remplir tous les critères suivants :

Windows

  • Autorisations d’administrateur sur la machine où vous installez Resource Monitoring Tool.
  • Rôle sur le site d’administrateur Tableau Server.
  • Compte administrateur Resource Monitoring Tool.

Linux

  • Accès sudo complet pour le compte utilisateur utilisé pour installer l’Agent.
  • Compte administrateur Resource Monitoring Tool

Étape suivante

Installer l’Agent à la ligne de commande

Retour en haut