Aide de Tableau Server sur Linux

Le Tableau Resource Monitoring Tool utilise une base de données PostgreSQL comme référentiel pour collecter et stocker les données de surveillance de Tableau Server qui sont utilisées pour fournir des informations sur les performances et l’utilisation. Cette base de données est distincte de la base de données Tableau Server.

Avant la version 2022.3, ce référentiel PostgreSQL était automatiquement installé avec le serveur RMT sur la même machine que le serveur RMT et c’était la seule option disponible. Depuis la version 2022.3, vous pouvez reconfigurer le serveur RMT pour utiliser une base de données PostgreSQL hébergée en externe au lieu de la base de données installée localement. Lorsque le serveur RMT est configuré pour utiliser une base de données PostgreSQL hébergée en externe, nous l’appelons référentiel externe.

La plateforme prise en charge pour l’hébergement du référentiel externe est une instance AWS RDS. L’hébergement de la base de données du référentiel en externe vous permet de gérer la disponibilité, les sauvegardes et la reprise après sinistre du composant de référentiel du serveur RMT.

Avec l’ajout de cette option pour configurer un référentiel externe, le serveur RMT peut être configuré des manières suivantes :

• Continuer à utiliser le référentiel installé localement : cela signifie que la base de données PostgreSQL qui est automatiquement installée avec le serveur RMT sur la même machine sera utilisée comme référentiel pour le serveur RMT, et aucune autre modification n’est apportée à cette configuration.

• Configurer le serveur RMT pour utiliser un référentiel externe : cela signifie que la base de données PostgreSQL utilisée par RMT est hébergée à l’extérieur du serveur RMT. Cela nécessite d’apporter quelques modifications à la configuration après l’installation. Actuellement, seules les instances AWS RDS sont prises en charge en tant que plateforme d’hébergement pour la base de données PostgreSQL.

Afin de configurer et de gérer le référentiel externe, vous devez avoir une bonne compréhension de la plateforme AWS RDS et de la base de données PostgreSQL. Nous vous recommandons d’utiliser la documentation sur le site AWS pour les instructions relatives à la plateforme.

Vous devrez également savoir comment configurer et gérer la configuration du référentiel externe pour Resource Monitoring Tool. Cette rubrique vous fournira ces informations dans les sections ci-dessous.

Les instructions détaillées dans cette section s’appliquent à une nouvelle installation de Resource Monitoring Tool. Si vous avez un déploiement existant de RMT et que vous souhaitez passer à une configuration de référentiel externe, consultez la section Installation Resource Monitoring Tool existante de cette rubrique.

Lorsque vous installez le serveur RMT, il installe automatiquement la base de données du référentiel sur la même machine que le serveur RMT. Le processus de configuration du référentiel externe est une configuration post-installation dans laquelle vous allez reconfigurer le serveur RMT pour utiliser une base de données PostgreSQL hébergée en externe.

Utilisez les étapes suivantes pour installer Resource Monitoring Tool et reconfigurer le serveur RMT afin d’utiliser un référentiel externe :

1. Créer le référentiel externe : créez une instance RDS pour héberger le référentiel externe avec les recommandations suivantes.

   • Spécifications minimales recommandées pour l’instance PostgreSQL :

     • db.m6g.2xlarge (8 vcpu, 32 Go de RAM)

     • Stockage SSD avec 500 Go d’espace disque

   • Valeurs de configuration de l’instance :

     • Nombre maximum de processus de travail : nombre total de processeurs logiques

     • Nombre maximum de travailleurs par rassemblement : min (total des processeurs logiques / 2, 4)

     • Nombre maximum de travailleurs parallèles : nombre total de processeurs logiques

     • Travailleurs de maintenance parallèles max. : Min (total des processeurs logiques / 2, 4)

     • Tampons partagés : Mémoire totale / 4

     • Taille effective du cache : 75 % de la mémoire totale

     • Mémoire de travail de maintenance : Mémoire totale / 16 Linux, max. 2 Go - 1 Mo sous Windows

     • Wal Buffers : Dérivé de Shared Buffers, probablement autour de 16 Mo

     • Mémoire de travail : dérivée des tampons partagés et du nombre maximal de travailleurs par collecte

   Pour savoir comment créer et se connecter à une instance de base de données PostgreSQL sur AWS, consultez cette page sur le site de documentation AWS.

2. Installer RMT : Suivez les instructions Installer le Serveur RMT à la ligne de commande pour installer le serveur RMT, mais ignorez les étapes de création d’un environnement. Vous le ferez plus tard après avoir configuré le serveur RMT pour utiliser le référentiel externe. Notez que cela installera initialement une base de données PostgreSQL locale.

3. Testez la connexion au référentiel externe : testez la connexion à la nouvelle base de données à l’aide de psql, un outil d’administration PostgreSQL installé avec le serveur RMT.

   • Accédez au dossier ‘bin’ du répertoire d’installation de PostgreSQL installé localement.

     /var/opt/tableau/tabrmt/prerequisites/postgresql<version number>/bin

   • Exécutez la commande suivante pour tester la connexion. Remplacez votre propre valeur ci-dessous par aws_rds_servername et fournissez le mot de passe PostgreSQL que vous avez créé dans AWS lorsque vous y êtes invité.

     psql -h <aws_rds_servername> -p 5432 -d postgres -U postgres

     Si vous recevez une erreur à ce stade et que vous ne parvenez pas à vous connecter, vérifiez les valeurs des paramètres dans la commande par rapport aux valeurs de la console AWS RDS.

   • Une fois la connexion établie avec succès, vous pouvez fermer la session psql avec la commande suivante :

     \q

4. Exécutez rmtadmin master-setup pour configurer le serveur RMT pour utiliser le référentiel externe. Utilisez les exemples de commande suivants et modifiez la commande pour refléter votre chemin d’installation Resource Monitoring Tool, le nom de l’instance AWS RDS, le numéro de port et le mot de passe de l’utilisateur administrateur RDS PostgreSQL :

   • Accédez au répertoire d’installation du serveur RMT Resource Monitoring Tool :

     sudo /var/opt/tableau/tabrmt/master

   • Exécutez la commande pour configurer le référentiel externe :

     rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>

5. Créez maintenant un environnement et téléchargez le fichier bootstrap :

   • 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>

   • Téléchargez le fichier bootstrap pour enregistrer les agents :

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

     Les étapes sont décrites en détail ici : Installer le Serveur RMT à la ligne de commande.

6. Suivez les instructions Installer l’Agent à la ligne de commande pour installer et enregistrer des agents sur les nœuds Tableau Server.

Dans cette version, pour configurer le dépôt externe, vous devrez essentiellement commencer par une nouvelle installation de Tableau Resource Monitoring Tool en suivant les étapes décrites dans la section ci-dessus.

Voici les étapes générales que vous devez suivre si vous souhaitez mettre à niveau Tableau Resource Monitoring Tool et migrer vers un référentiel externe en même temps :

Migration avec recréation de l’environnement :

1. Mettez à niveau le serveur RMT et tous les agents vers la version 2022.3 ou ultérieure.

2. Les étapes 2 à 4 sont très similaires aux étapes que vous prendriez pour effectuer une nouvelle installation - consultez Nouvelle installation de Resource Monitoring Tool ci-dessus. Cela implique principalement :

   • Créez une instance de base de données AWS PostgreSQL.

   • Configurez le serveur RMT pour utiliser le référentiel externe.

   • Recréez des environnements et réenregistrez tous les agents.

3. Reconfigurez toutes les configurations personnalisées.

Remarque : Vous perdrez des données historiques et devrez également reconfigurer toutes les configurations personnalisées.

Lorsqu’il y a un changement dans l’exigence de version majeure de PostgreSQL pour Resource Monitoring Tool, il est recommandé de mettre à niveau la version de PostgreSQL du référentiel externe avant de mettre à niveau Resource Monitoring Tool. Plus de détails sont fournis ci-dessous. Pour savoir si vous devez mettre à niveau votre version PostgreSQL du référentiel externe, consultez le tableau de compatibilité des produits.

Suivez les étapes ci-dessous pour mettre à niveau RMT et l’instance RDS lorsqu’une mise à niveau de la version majeure de PostgreSQL est requise.

1. Faites une sauvegarde de votre instance RDS. Vous en aurez besoin au cas où vous auriez besoin d’annuler la mise à niveau. Pour plus d’informations, consultez la rubrique Sauvegarde et restauration d’une instance de base de données Amazon RDS sur le site AWS.

2. Faites une copie du fichier de configuration dans le répertoire Resource Monitoring Tool. Le fichier de configuration se trouve à :

   /var/opt/tableau/tabrmt/master/config.json

3. Mettez à niveau l’instance RDS vers la nouvelle version de PostgreSQL Pour plus d’informations, consultez la rubrique Mise à niveau du moteur de base de données PostgreSQL pour Amazon RDS sur le site AWS.

4. Mettez à niveau le serveur RMT. Si la mise à niveau, y compris la migration de la base de données, se termine avec succès, passez à l’étape suivante. Si la mise à niveau échoue, consultez les instructions de cette section sur la façon de récupérer et d’annuler la mise à niveau.

5. Mettez à niveau tous les agents sur les nœuds Tableau Server vers la nouvelle version de RMT. Pour plus d’informations, consultez Mise à niveau de Resource Monitoring Tool.

Récupération d’une mise à niveau ayant échoué

1. Désinstallez le serveur RMT mis à niveau.

2. Restaurez l’instance AWS RDS vers la version antérieure à la mise à niveau. Pour plus d’informations, consultez la rubrique Sauvegarde et restauration d’une instance de base de données Amazon RDS sur le site AWS.

3. Remplacez le fichier de configuration que vous avez sauvegardé avant la mise à niveau à l’emplacement suivant. Vous devrez peut-être créer ce dossier car il a peut-être été supprimé lors de la désinstallation :

   /var/opt/tableau/tabrmt/master/config.json

4. Installez le serveur RMT qui installe un référentiel local.

5. Configurez le serveur RMT pour utiliser le référentiel externe :

   rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>

Ce tableau répertorie uniquement les versions 2022.3 et ultérieures de RMT, car le référentiel externe n’est disponible qu’à partir de la version 2022.3 et ultérieure.

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

• Compte utilisateur avec accès sudo complet.
• Rôle sur le site d’administrateur Tableau Server.
• Compte administrateur Resource Monitoring Tool.