Aide de Tableau Server sur Linux

Tableau Resource Monitoring Tool utilise une base de données PostgreSQL comme référentiel pour recueillir et stocker les données de surveillance de Tableau Server destinées à fournir des informations de performances et d’utilisation.

Avant la version 2022.3, ce référentiel PostgreSQL était automatiquement installé avec le Serveur RMT, sur le même ordinateur que le Serveur RMT, et c’était la seule option disponible. Depuis la version 2022.3, vous pouvez reconfigurer le Serveur RMT de manière à 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 la désignons sous le terme de référentiel externe.

La plate-forme 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 de 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.

Grâce à l’ajout de cette option de configuration d’un référentiel externe, le Serveur RMT peut être configuré de plusieurs manières :

• Continuer à utiliser le référentiel installé localement :dans ce cas de figure, 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 ne sera apportée à cette configuration.
• Configurer le Serveur RMT de manière à utiliser le référentiel externe : dans ce cas de figure, la base de données PostgreSQL utilisée par RMT est hébergée de manière externe au Serveur RMT. Ce choix nécessite quelques modifications de configuration après l’installation. Actuellement, seules les instances AWS RDS sont prises en charge en tant que plate-forme d’hébergement pour la base de données PostgreSQL.

Pour configurer et gérer le référentiel externe, vous devez avoir une compréhension solide de la plate-forme 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 plate-forme.

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.

Nouvelle installation de Resource Monitoring Tool

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 souhaitez passer à une configuration de référentiel externe, consultez la section Installation Resource Monitoring Tool existante dans cette rubrique.

Lorsque vous installez le Serveur RMT, il installe automatiquement la base de données de 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 où vous allez reconfigurer le Serveur RMT de manière à ce qu’il utilise une base de données PostgreSQL hébergée en externe.

Suivez la procédure ci-après pour installer Resource Monitoring Tool et reconfigurer le Serveur RMT de manière à ce qu’il utilise 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 en appliquant les recommandations suivantes.

   • Spécifications minimum recommandées de l’instance PostgreSQL :

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

     • Stockage SSD avec 500 Go d’espace disque

   • Valeurs de configuration de l’instance :

     • Nombre maximum de processus worker : Total de processeurs logiques

     • Nombre maximum de workers par collecte : Min(Total de processeurs logiques / 2, 4)

     • Nombre maximum de workers parallèles : processeurs logiques totaux

     • Nombre maximum de workers parallèles par collecte : Min(Total de 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 dans Windows

     • Tampons Wal : dérivé des tampons partagés, probablement autour de 16 Mo

     • Mémoire de travail : dérivé des tampons partagés et du nombre maximum de workers par collecte

   Pour savoir comment créer une instance de base de données PostgreSQL sur AWS et s’y connecter, 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 y viendrez plus tard après avoir configuré le Serveur RMT de manière à ce qu’il utilise le référentiel externe. Notez que cette opération installera initialement une base de données PostgreSQL locale.

3. Tester la connexion au référentiel externe : testez la connexion à la nouvelle base de données en utilisant psql, un outil d’administration de PostgreSQL qui est installé avec le Serveur RMT.

   Accédez au dossier 'bin' du répertoire d’installation de PostgreSQL installé en local.

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

   Exécutez la commande suivante pour tester la connexion. Remplacez aws_rds_servername par votre propre valeur ci-dessous et fournissez le mot de passe PostgreSQL que vous avez créé dans AWS à l’invite.

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

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

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

   \q

4. Exécutez rmtadmin master-setup pour configurer le Serveur RMT de manière à ce qu’il utilise le référentiel externe. Utilisez les exemples de commandes suivants et modifiez la commande afin de refléter votre chemin d’installation de Resource Monitoring Tool, le nom de l’instance AWS RDS, le numéro de port et le mot de passe utilisateur de l’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-port=5432 --db-admin-username=postgres --db-admin-password='postgres_user_password'

5. Maintenant, créez 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 intégralement dans cette section : Installer le Serveur RMT à la ligne de commande.

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

Installation Resource Monitoring Tool existante

Dans cette version, pour configurer le référentiel externe, vous devrez démarrer avec une nouvelle installation de Tableau Resource Monitoring Tool en suivant les étapes décrites dans la section ci-dessus.

Meilleures pratiques de mise à niveau

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 nécessaires à une nouvelle installation. Consultez Nouvelle installation de Resource Monitoring Tool ci-dessus. Cette procédure implique principalement les actions suivantes :
   • Création d’une instance de base de données AWS PostgreSQL.
   • Configuration du Serveur RMT de manière à ce qu’il utilise le référentiel externe.
   • Recréation des environnements et réenregistrement de tous les Agents.
3. Reconfiguration de toutes les configurations personnalisées.

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

La mise à niveau lorsque la nouvelle version de RMT nécessite une mise à niveau majeure de PostgreSQL

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

Utilisez les étapes suivantes pour mettre à niveau RMT et l’instance RDS lorsqu’une mise à niveau de la version majeure de PostgreSQL est requise

1. Effectuez 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 Sauvegarde et restauration d’une instance de base de données Amazon RDS sur le site d’AWS.
2. Faites une copie du fichier de configuration dans le répertoire Resource Monitoring Tool. Le fichier de configuration se trouve à l’adresse :
   /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 d’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 récupération et la l’annulation de 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 à 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 d’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 la Serveur RMT, ce 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-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password> .

Compatibilité des versions RMT et PostgreSQL

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

Qui dispose des autorisations nécessaires ?

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.