Help bij Tableau Server op Linux

De Resource Monitoring Tool van Tableau gebruikt een PostgreSQL-database als opslagplaats voor het verzamelen en opslaan van data over Tableau Server-bewaking. Deze wordt gebruikt om informatie over prestaties en gebruik te verstrekken. Deze database is gescheiden van de Tableau Server-database.

Vóór de release van 2022.3 werd deze PostgreSQL-opslagplaats automatisch geïnstalleerd met de RMT Server, op dezelfde machine als de RMT Server. Dit was de enige beschikbare optie. Vanaf versie 2022.3 kunt u RMT Server opnieuw configureren om een extern gehoste PostgreSQL-database te gebruiken in plaats van de lokaal geïnstalleerde database. Wanneer RMT Server is geconfigureerd voor gebruik van extern gehoste PostgreSQL-database, noemen we dit de externe opslagplaats.

Het ondersteunde platform voor het hosten van de externe opslagplaats is een AWS RDS-exemplaar. Door de database van de opslagplaats extern te hosten, kunt u de beschikbaarheid, back-ups en noodherstel van de opslagplaats van de RMT Server beheren.

Door het toevoegen van deze optie om een externe opslagplaats te configureren, kan RMT Server op de volgende manieren worden geconfigureerd:

• De lokaal geïnstalleerde opslagplaats blijven gebruiken: dit betekent dat de PostgreSQL-database die automatisch met RMT Server op dezelfde computer wordt geïnstalleerd, wordt gebruikt als opslagplaats voor RMT Server en dat er geen verdere wijzigingen in deze configuratie worden aangebracht.

• RMT Server configureren om een externe opslagplaats te gebruiken: dit betekent dat de PostgreSQL-database die RMT gebruikt, extern ten opzichte van RMT Server wordt gehost. Hiervoor moeten na de installatie enkele configuratiewijzigingen worden doorgevoerd. Momenteel worden alleen AWS RDS-exemplaren ondersteund als hostingplatform voor PostgreSQL-databases.

Om de externe opslagplaats in te stellen en te beheren, moet u goede kennis hebben van het AWS RDS-platform en de PostgreSQL-database. We raden u aan om de documentatie op de AWS-site te gebruiken voor aan platforms gerelateerde instructies.

U moet ook weten hoe u de externe opslagplaats configureert en beheert voor Resource Monitoring Tool. In dit onderwerp vindt u de informatie hierover in de onderstaande secties.

De instructies in dit deel zijn van toepassing op een nieuwe installatie van Resource Monitoring Tool. Als u een bestaande implementatie van RMT hebt en wilt overstappen naar een configuratie voor een externe opslagplaats, raadpleegt u het deel Bestaande Resource Monitoring Tool-installatie van dit onderwerp.

Wanneer u RMT Server installeert, wordt de database van de opslagplaats automatisch op dezelfde computer geïnstalleerd als de RMT Server. Het proces voor het configureren van de externe opslagplaats is een configuratie na de installatie. Hierbij configureert u RMT Server opnieuw voor gebruik van een extern gehoste PostgreSQL-database.

Gebruik de volgende stappen om Resource Monitoring Tool te installeren en RMT Server opnieuw configureren voor gebruik van een externe opslagplaats:

1. De externe opslagplaats maken: maak een RDS-exemplaar om de externe opslagplaats te hosten met de volgende aanbevelingen.

   • Aanbevolen minimale specificaties voor PostgreSQL-exemplaren:

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

     • SSD-opslag met 500 GB schijfruimte

   • Waarden voor configuratie van exemplaar:

     • Max. workerprocessen: totaal aantal logische processoren

     • Max. workers per verzameling: min, (totaal aantal logische processoren / 2, 4)

     • Max. parallel workers: totaal aantal logische processoren

     • Max. parallelle onderhoudsworkers: min. (totaal aantal logische processoren / 2, 4)

     • Gedeelde buffers: totaal geheugen / 4

     • Effectieve cachegrootte: 75% van het totale geheugen

     • Geheugen voor onderhoudswerk: totaal geheugen / 16 Linux, max. 2 GB, 1 MB in Windows

     • Wal buffers: Afgeleid van gedeelde buffers, waarschijnlijk rond de 16 MB

     • Werkgeheugen: afgeleid van gedeelde buffers en max. workers per verzameling

   Zie deze pagina op de AWS-documentatiesite voor meer informatie over het maken en verbinden van een PostgreSQL Db-exemplaar op AWS.

2. RMT installeren: volg de instructies De RMT-server installeren via de opdrachtregel om RMT Server te installeren, maar: sla de stappen voor het aanmaken van een omgeving over. U doet dit later nadat u RMT Server hebt geconfigureerd om de externe opslagplaats te gebruiken. Houd er rekening mee dat hiermee in eerste instantie een lokale PostgreSQL-database wordt geïnstalleerd.

3. De verbinding met de externe opslagplaats testen: test de verbinding met de nieuwe database met psql. Dit is een PostgreSQL-beheerprogramma dat samen met de RMT-server is geïnstalleerd;

   • Ga naar de map 'bin' van de lokaal geïnstalleerde PostgreSQL-installatiedirectory.

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

   • Voer de volgende opdracht uit om de verbinding te testen: Vervang hieronder uw eigen waarde door aws_rds_servernaam. Geef het PostgreSQL-wachtwoord op dat u in AWS hebt gemaakt wanneer u daarom wordt gevraagd.

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

     Als u op dit punt een foutmelding krijgt en geen verbinding kunt maken, controleer dan de parameterwaarden in de opdracht met de waarden in de AWS RDS-console.

   • Zodra de verbinding met succes tot stand is gebracht, kunt u de psql-sessie sluiten met de volgende opdracht:

     \q

4. Voer rmtadmin master-setup uit om RMT Server te configureren voor gebruik van de externe opslagplaats. Gebruik de volgende opdrachtvoorbeelden en bewerk de opdracht om deze aan te passen aan uw wensen. Resource Monitoring Tool installatiepad, naam van AWS RDS-exemplaar, poortnummer en het RDS PostgreSQL-beheerderswachtwoord:

   • Ga naar de Resource Monitoring Tool RMT Server-installatiedirectory:

     sudo /var/opt/tableau/tabrmt/master

   • Voer de opdracht uit om een externe opslagplaats te configureren:

     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. Maak nu een omgeving en download het bootstrap-bestand:

   • Voer de volgende opdracht uit om een omgeving te maken:

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

   • Download het bootstrap-bestand om agents te registreren:

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

     De stappen worden hier uitgebreid beschreven: De RMT-server installeren via de opdrachtregel.

6. Volg de instructies De agent installeren via de opdrachtregel om agents te installeren en registreren op Tableau Server-knooppunten.

In deze release moet u, om de externe opslagplaats te configureren, in principe beginnen met een nieuwe installatie van Resource Monitoring Tool van Tableau met behulp stappen die worden beschreven in het bovenstaand gedeelte.

Dit zijn de algemene stappen die u moet volgen als u Tableau Resource Monitoring Tool wilt upgraden en tegelijkertijd naar een externe opslagplaats wilt migreren:

Migratie met opnieuw aanmaken in de omgeving:

1. Upgrade RMT Server en alle agents naar 2022.3 of later.

2. Stappen 2-4 lijken erg op de stappen die u zou nemen om een nieuwe installatie uit te voeren. Zie Nieuwe installatie van Resource Monitoring Tool hierboven. Het gaat hierbij vooral om:

   • Een AWS PostgreSQL Db-exemplaar maken.

   • RMT Server configureren om de externe opslagplaats te gebruiken.

   • Omgevingen opnieuw aanmaken en alle agents opnieuw registreren.

3. Eventuele aangepaste configuraties opnieuw configureren.

Opmerking: u verliest historische data en moet bovendien eventuele aangepaste configuraties opnieuw configureren.

Wanneer er een wijziging is in de vereiste voor de PostgreSQL-hoofdversie voor Resource Monitoring Tool, is het een beste werkwijze om eerst de externe PostgreSQL-versie van de opslagplaats te upgraden voordat u een upgrade uitvoert voor Resource Monitoring Tool. Meer details vindt u hieronder. Om te zien of u uw externe PostgreSQL-versie moet upgraden, raadpleegt u de tabel voor Productcompatibiliteit.

Gebruik de volgende stappen om RMT en het RDS-exemplaar te upgraden wanneer een upgrade voor de PostgreSQL-hoofdversie vereist is

1. Maak een back-up van uw RDS-exemplaar. U hebt deze back-up nodig als u de upgrade wilt terugdraaien. Zie het onderwerp Back-up maken en herstel van een Amazon RDS DB-exemplaar op de AWS-site voor meer informatie.

2. Maak een kopie van het configuratiebestand in de directoryResource Monitoring Tool. Het configuratiebestand bevindt zich op:

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

3. Werk het RDS-exemplaar bij naar de nieuwe versie van PostgreSQL. Zie het onderwerp Upgraden van de PostgreSQL DB-engine voor Amazon RDS op de AWS-site voor meer informatie.

4. RMT Server upgraden. Als de upgrade, inclusief de databasemigratie, is voltooid, gaat u verder met de volgende stap. Als de upgrade mislukt, raadpleeg dan de instructies in dit gedeelte over hoe u de upgrade kunt herstellen en terugdraaien.

5. Upgrade alle agents op Tableau Server-knooppunten naar de nieuwe RMT-versie. Zie Resource Monitoring Tool upgraden voor meer informatie.

Herstellen van een mislukte upgrade

1. Verwijder de RMT-server waarvoor een upgrade is uitgevoerd.

2. Herstel het AWS RDS-exemplaar naar de versie van vóór de upgrade. Zie het onderwerp Back-up maken en herstellen van een Amazon RDS DB-exemplaar op de AWS-site voor meer informatie.

3. Vervang het configuratiebestand waarvan u vóór de upgrade een back-up hebt gemaakt op de volgende locatie. Mogelijk moet u deze map aanmaken, omdat deze mogelijk is verwijderd tijdens het verwijderen:

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

4. Installeer RMT Server, waarbij een lokale opslagplaats wordt geïnstalleerd.

5. Configureer RMT Server om de externe opslagplaats te gebruiken:

   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>

In deze tabel worden alleen RMT-versie 2022.3 en later weergegeven, omdat externe opslagplaatsen alleen beschikbaar zijn vanaf versie 2022.3 en later.

Om Resource Monitoring Tool te installeren, moet u over het volgende beschikken:

• Gebruikersaccount met volledige sudo-toegang.
• Siterol van Tableau Server-beheerder.
• Beheerdersaccount voor Resource Monitoring Tool.