Gids voor bedrijfsbrede implementatie van Tableau Server

In dit onderwerp wordt beschreven hoe u de installatie en configuratie van de basisimplementatie van Tableau Server voltooit. De procedure wordt uiteengezet aan de hand van het voorbeeld voor de AWS- en Linux-referentiearchitectuur.

De Linux-voorbeelden in deze installatieprocedures tonen opdrachten voor RHEL-achtige distributies. De hier gebruikte opdrachten zijn specifiek ontwikkeld met de Amazon Linux 2-distributie. Als u de Ubuntu-distributie gebruikt, moet u de opdrachten dienovereenkomstig bewerken.

U moet uw omgeving voorbereiden en valideren zoals beschreven in Deel 3 – De implementatie van Tableau Server Enterprise voorbereiden.

Deze PostgreSQL-instantie host de externe opslagplaats voor de Tableau Server-implementatie. U moet PostgreSQL installeren en configureren voordat u Tableau installeert.

U kunt PostgreSQL uitvoeren op Amazon RDS of op een EC2-instantie. Zie Externe opslagplaats Tableau Server (Linux(Link wordt in een nieuw venster geopend)) voor meer informatie over de verschillen tussen het uitvoeren van de opslagplaats op RDS en een EC2-instantie.

De onderstaande procedure laat zien hoe u Postgres op een Amazon EC2-instantie installeert en configureert. Het hier getoonde voorbeeld is een algemene installatie en configuratie voor PostgreSQL in de referentiearchitectuur. Uw DBA moet de PostgreSQL-implementatie optimaliseren op basis van de omvang van de data en prestatiebehoeften.

Vereisten: houd er rekening mee dat u PostgreSQL 1.6 moet gebruiken en dat u de module uuid-ossp moet installeren.

U moet compatibele hoofdversies van PostgreSQL installeren voor de externe opslagplaats van Tableau Server. Daarnaast moeten ook kleinere versies aan minimumvereisten voldoen.

Deze voorbeeldinstallatieprocedure beschrijft hoe u PostgreSQL versie 13.6 installeert.

Meld u aan bij de EC2-host die u in het vorige deel hebt gemaakt.

1. Voer een update uit om de nieuwste oplossingen voor het Linux-besturingssysteem toe te passen:

   sudo yum update

2. Maak en bewerk het bestand pgdg.repo. in het pad /etc/yum.repos.d/. Vul het bestand met de volgende configuratiedata:

   [pgdg13]
   name=PostgreSQL 13 for RHEL/CentOS 7 - x86_64
   baseurl=https://download.postgresql.org/pub/repos/yum/13/redhat/rhel-7-x86_64
   enabled=1
   gpgcheck=0

3. Installeer Postgres 13.6:

   sudo yum install postgresql13-server-13.6-1PGDG.rhel7.x86_64

4. Installeer de uuid-ossp module:

   sudo yum install postgresql13-contrib-13.6-1PGDG.rhel7.x86_64

5. Initialiseer Postgres:

   sudo /usr/pgsql-13/bin/postgresql-13-setup initdb

Rond de basisinstallatie af door Postgres te configureren:

1. Werk het configuratiebestand pg_hba /var/lib/pgsql/13/data/pg_hba.conf bij met de volgende twee zinnen. Elke zin moet het masker bevatten van de subnetten waarop uw Tableau-servers worden uitgevoerd: 

   host all all 10.0.30.0/24 password

   host all all 10.0.31.0/24 password

2. Werk het PostgreSQL-bestand /var/lib/pgsql/13/data/postgresql.conf bij door deze zin toe te voegen:

   listen_addresses = '*'

3. Configureer om Postgres te starten bij opnieuw opstarten:

   sudo systemctl enable --now postgresql-13

4. Stel het wachtwoord voor de supergebruiker in:

   sudo su - postgres 

   psql -c "alter user postgres with password 'StrongPassword'"

   Opmerking: Stel een sterk wachtwoord in. Gebruik dus niet 'StrongPassword' zoals in het voorbeeld hierboven.

   exit

5. Postgres opnieuw starten:

   sudo systemctl restart postgresql-13

Maak een tar-back-up van de PostgreSQL-configuratie. Door een tar-momentopname van de huidige configuratie te maken, bespaart u tijd als u tijdens de implementatie fouten tegenkomt.

We noemen dit de back-up van Stap 1.

Op de PostgreSQL-host:

1. Zet de Postgres-database-instantie stop:

   sudo systemctl stop postgresql-13

2. Voer de volgende opdrachten uit om de tar-back-up te maken:

   sudo su

   cd /var/lib/pgsql

   tar -cvf step1.13.bkp.tar 13

   exit

3. Start de Postgres-database:

   sudo systemctl start postgresql-13

Als u Tableau implementeert volgens de voorbeeldimplementatie van AWS/Linux die in deze gids wordt beschreven, kunt u mogelijk het geautomatiseerde installatiescript TabDeploy4EDG uitvoeren. Met het script TabDeploy4EDG wordt de voorbeeldinstallatie van de Tableau-implementatie met vier knooppunten geautomatiseerd. Deze implementatie wordt beschreven in de volgende procedures. Zie Bijlage – AWS Deployment Toolbox.

Deze procedure beschrijft hoe u het eerste knooppunt van Tableau Server installeert zoals gedefinieerd door de referentiearchitectuur. Met uitzondering van de pakketinstallatie en de initialisatie van TSM, maakt de hier weergegeven procedure waar mogelijk gebruik van de TSM-opdrachtregel. Naast het feit dat TSM CLI platformonafhankelijk is, zorgt het gebruik ervan voor een naadloze installatie in gevirtualiseerde en headless omgevingen.

1. Meld u aan bij de hostserver van Knooppunt 1.

2. Geef in deze stap de productcode(s) van Tableau Server op. Voer de volgende opdracht uit voor elke licentiesleutel die u hebt gekocht:

   tsm licenses activate -k <product key>

3. Maak een json-registratiebestand met de notatie zoals hier getoond:

   {
   "zip" : "97403",
   "country" : "USA",
   "city" : "Springfield",
   "last_name" : "Simpson",
   "industry" : "Energy",
   "eula" : "yes",
   "title" : "Safety Inspection Engineer",
   "company_employees" : "100",
   "phone" : "5558675309",
   "company" : "Example",
   "state" : "OR",
   "opt_in" : "true",					
   "department" : "Engineering",
   "first_name" : "Homer",
   "email" : "homer@example.com"
   }	

4. Nadat u de wijzigingen in het bestand hebt opgeslagen, geeft u dit door met de optie --file om Tableau Server te registreren:

   tsm register --file path_to_registration_file.json

Opmerking: Als uw implementatie gebruikmaakt van externe opslag voor het Tableau Bestandsarchief, moet u het Externe bestandsarchief inschakelen voordat u het identiteitenarchief configureert. Zie Tableau Server installeren met extern bestandsarchief (Linux(Link wordt in een nieuw venster geopend)).

De standaard referentiearchitectuur maakt gebruik van een lokaal identiteitenarchief. Configureer de initiële host met een lokaal identiteitenarchief door middel van het bestand config.json met de opdracht tsm settings import.

Importeer het bestand config.json volgens uw besturingssysteem:

Het bestand config.json is opgenomen in het directorypad scripts.<versie> (bijvoorbeeld scripts.20204.21.0217.1203), en is geformatteerd om het identiteitenarchief te configureren.

Om het bestand config.json te importeren, voert u de volgende opdracht uit:

tsm settings import -f /app/tableau_server/packages/scripts.<version_code>/config.json

1. Maak een extern database-json-bestand met de volgende configuratie-instellingen:

   {
   "flavor":"generic",
   "masterUsername":"postgres",
   "host":"<instance ip address>",
   "port":5432
   }

2. Nadat u de wijzigingen in het bestand hebt opgeslagen, zet u het bestand door met de volgende opdracht:

   tsm topology external-services repository enable -f <filename>.json --no-ssl

   U wordt gevraagd om het wachtwoord van de primaire Postgres-gebruikersnaam.

   Met de optie --no-ssl configureert u Tableau om SSL/TLS alleen te gebruiken wanneer de Postgres-server is geconfigureerd voor SSL/TLS. Als Postgres niet is geconfigureerd voor SSL/TLS, is de verbinding niet versleuteld. Deel 6 - Configuratie na de installatie beschrijft hoe u SSL/TLS voor de Postgres-verbinding kunt inschakelen nadat u de eerste fase van de implementatie hebt voltooid.

3. Pas de wijzigingen toe.

   Voer deze opdracht uit om de wijzigingen toe te passen en Tableau Server opnieuw te starten:

   tsm pending-changes apply

4. Verwijder het configuratiebestand dat u in stap 1 hebt gebruikt.

1. Nadat u Tableau Server hebt geïnstalleerd, moet u de server initialiseren.

   Voer de volgende opdracht uit:

   tsm initialize --start-server --request-timeout 1800

2. Wanneer de initialisatie is voltooid, moet u een Tableau Server-beheerdersaccount maken.

   In tegenstelling tot het computeraccount dat u gebruikt om TSM-besturingssysteemcomponenten te installeren en beheren, is het Tableau Server-beheerdersaccount een toepassingsaccount dat wordt gebruikt voor het maken van Tableau Server-gebruikers, -projecten en -sites. De Tableau Server-beheerder past ook machtigingen toe op Tableau-resources. Voer de volgende opdracht uit om het initiële beheerdersaccount aan te maken. In het volgende voorbeeld wordt de gebruiker tableau-admin genoemd:

   tabcmd initialuser --server http://localhost --username "tableau-admin"

   Tabcmd vraagt u om een wachtwoord voor deze gebruiker in te stellen.

1. Voer de volgende opdracht uit om te controleren of de TSM-services actief zijn:

   tsm status -v

   Tableau zou het volgende moeten retourneren:

   external: 
   Status: RUNNING
   'Tableau Server Repository 0' is running (Active Repository).
   node1: localhost
   Status: RUNNING
   'Tableau Server Gateway 0' is running.
   'Tableau Server Application Server 0' is running.
   'Tableau Server Interactive Microservice Container 0' is running.
   'MessageBus Microservice 0' is running.
   'Relationship Query Microservice 0' is running.
   'Tableau Server VizQL Server 0' is running. 
   ...

   Alle services worden vermeld.

2. Voer de volgende opdracht uit om te controleren of de beheerderssite van Tableau actief is:

   curl localhost

   De eerste paar regels zouden Vizportal-html moeten weergeven, vergelijkbaar met:

   <!DOCTYPE html>
   <html xmlns:ng="" xmlns:tb="">
   <head ng-csp>
   <meta charset="UTF-8">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
   <meta name="viewport" content="initial-scale=1, maximum-scale=2, width=device-width, height=device-height, viewport-fit=cover">
   <meta name="format-detection" content="telephone=no">
   <meta name="vizportal-config ...

Nadat u de eerste installatie hebt geverifieerd, maakt u twee tar-back-ups:

• PostgreSQL
• Tableau eerste knooppunt (Knooppunt 1)

In de meeste gevallen kunt u de installatie van het eerste knooppunt terugzetten door deze tar-bestanden te herstellen. Het herstellen van de tar-bestanden gaat veel sneller dan het opnieuw installeren en initialiseren van het eerste knooppunt.

{
"initialBootstrapSettings" : {
	"certificate" : "-----BEGIN CERTIFICATE-----\r\...=\r\n-----END CERTIFICATE-----",
	"port" : 8850,
	"configurationName" : "tabsvc",
	"clusterId" : "tabsvc-clusterid",
	"cryptoKeyStore" : "zs7OzgAAAAIAAAABAAAAA...w==",
	"toksCryptoKeystore" : "LS0tLS1CRUdJTiBUT00tLS0tCjM5MDBh...L",
	"sessionCookieMaxAge" : 7200,
	"nodeId" : "node1",
	"machineAddress" : "ip-10-0-1-93.us-west-1.compute.internal",
	"cryptoEnabled" : true,
	"sessionCookieUser" : "tsm-bootstrap-user",
	"sessionCookieValue" : "eyJjdHkiOiJKV1QiLCJlbmMiOiJBMTI4Q0JDLUhQ...",
	"sessionCookieName" : "AUTH_COOKIE"
	}
}

De Linux-voorbeelden in deze installatieprocedures tonen opdrachten voor RHEL-achtige distributies. Als u de Ubuntu-distributie gebruikt, moet u de opdrachten dienovereenkomstig bewerken.

1. Voer een update uit om de nieuwste oplossingen voor het Linux-besturingssysteem toe te passen:

   sudo yum update

2. Download en installeer afhankelijkheden:

   sudo yum deplist tableau-server-<version>.rpm | awk '/provider:/ {print $2}' | sort -u | xargs sudo yum -y install

3. Maak het pad /app/tableau_server aan in de hoofddirectory:

   sudo mkdir -p /app/tableau_server

4. Voer het installatieprogramma uit en geef het installatiepad /app/tableau_server op. Voer bijvoorbeeld op een Linux RHEL-achtig besturingssysteem het volgende uit:

   sudo rpm -i --prefix /app/tableau_server tableau-server-<version>.x86_64.rpm

U moet het Tableau Server-cluster configureren op het knooppunt waarop de Tableau Server - Beheercontroller (TSM-controller) draait. De TSM-controller draait op het eerste knooppunt.

1. Nadat u TSM hebt geïnitialiseerd met behulp van het bootstrap-bestand op Knooppunt 2, meldt u zich aan bij het eerste knooppunt.

2. Op het eerste knooppunt (node1) voert u de volgende opdrachten uit om processen op Knooppunt 2 te configureren:

   tsm topology set-process -n node2 -pr clustercontroller -c 1
   tsm topology set-process -n node2 -pr gateway -c 1
   tsm topology set-process -n node2 -pr vizportal -c 1
   tsm topology set-process -n node2 -pr vizqlserver -c 2
   tsm topology set-process -n node2 -pr cacheserver -c 2
   tsm topology set-process -n node2 -pr searchserver -c 1
   tsm topology set-process -n node2 -pr dataserver -c 2
   tsm topology set-process -n node2 -pr clientfileservice -c 1
   tsm topology set-process -n node2 -pr tdsservice -c 1
   tsm topology set-process -n node2 -pr collections -c 1
   tsm topology set-process -n node2 -pr contentexploration -c 1

   Als u versie 2022.1 of hoger installeert, voegt u ook de Indexerings- en zoekserver toe:

   tsm topology set-process -n node2 -pr indexandsearchserver -c 1

   Als u versie 2023.3 of hoger installeert, voegt u alleen de Indexerings- en zoekserver toe. Voeg de service Zoeken en bladeren (zoekserver) niet toe.

3. Controleer de configuratie voordat u deze toepast. Voer de volgende opdracht uit:

   tsm pending-changes list

4. Nadat u hebt gecontroleerd of uw wijzigingen in de lijst met in behandeling zijnde services staan (er staan ook andere services in de lijst met in behandeling zijnde services), past u de wijzigingen toe:

   tsm pending-changes apply

   De wijzigingen vereisen een herstart. Het configureren en opnieuw opstarten kan enige tijd duren.

5. Controleer de configuratie van Knooppunt 2. Voer de volgende opdracht uit:

   tsm status -v

Initialiseer TSM met behulp van het bootstrap-proces op Knooppunt 3 en voer vervolgens de tsm topology set-process-opdrachten hieronder uit.

Elke keer dat u een proces instelt, wordt er een Coördinatieservicewaarschuwing weergegeven. U kunt deze waarschuwing negeren terwijl u de processen instelt.

1. Nadat u TSM hebt geïnitialiseerd met behulp van het bootstrap-bestand op Knooppunt 3, meldt u zich aan bij het eerste knooppunt (node1) en voert u de volgende opdrachten uit om de processen te configureren:

   tsm topology set-process -n node3 -pr clustercontroller -c 1
   tsm topology set-process -n node3 -pr clientfileservice -c 1
   tsm topology set-process -n node3 -pr backgrounder -c 4
   tsm topology set-process -n node3 -pr filestore -c 1

   Als u versie 2022.1 of hoger installeert, voegt u ook de Indexerings- en zoekserver toe:

   tsm topology set-process -n node3 -pr indexandsearchserver -c 1

2. Controleer de configuratie voordat u deze toepast. Voer de volgende opdracht uit:

   tsm pending-changes list

3. Nadat u hebt gecontroleerd of uw wijzigingen in de lijst met in behandeling zijnde services staan (er staan ook andere services in de lijst die automatisch worden geconfigureerd), past u de wijzigingen toe:

   tsm pending-changes apply --ignore-warnings

   De wijzigingen vereisen een herstart. Het configureren en opnieuw opstarten kan enige tijd duren.

4. Verifieer de configuratie door de volgende opdracht uit te voeren:

   tsm status -v

Voor een standaard referentiearchitectuur-implementatie met vier knooppunten voert u de volgende procedure uit:

1. Voer de volgende opdrachten uit op Knooppunt 1:

   tsm stop
   tsm topology deploy-coordination-service -n node1,node2,node3

   Het proces omvat een herstart van TSM, wat enige tijd in beslag zal nemen.

2. Nadat de coördinatieservice is geïmplementeerd, start u TSM:

   tsm start

Nadat u de installatie hebt geverifieerd, maakt u vier tar-back-ups:

• PostgreSQL
• Tableau eerste knooppunt (Knooppunt 1)
• Tableau-knooppunt 2
• Tableau-knooppunt 3

De laatste stap in het procesconfiguratieproces is het verwijderen van redundante processen uit Knooppunt 1.

1. Maak verbinding met het eerste knooppunt (node1).

2. Schakel het bestandsarchief op Knooppunt 1 uit. Dit zal een waarschuwing veroorzaken over het verwijderen van het bestandsarchief van een controller die zich op dezelfde locatie bevindt. U kunt de waarschuwing negeren. Voer de volgende opdracht uit:

   tsm topology filestore decommission -n node1

3. Wanneer het bestandsarchief buiten gebruik is, voert u de volgende opdracht uit om het achtergrondproces van Knooppunt 1 te verwijderen:

   tsm topology set-process -n node1 -pr backgrounder -c 0

4. Controleer de configuratie voordat u deze toepast. Voer de volgende opdracht uit:

   tsm pending-changes list

5. Nadat u hebt gecontroleerd of uw wijzigingen in de lijst met in behandeling zijnde wijzigingen staan, past u de wijzigingen toe:

   tsm pending-changes apply

   De wijzigingen vereisen een herstart. Het configureren en opnieuw opstarten kan enige tijd duren.

6. Controleer de configuratie:

   tsm status -v.

   Voordat u verdergaat, wacht u tot het Bestandsarchief-proces op Knooppunt 4 klaar is met synchroniseren. De status van de Bestandsarchief-service zal is synchronizing retourneren totdat het proces klaar is. Wanneer de status van de Bestandsarchief-service is running retourneert, kunt u doorgaan.

Voor een volledig herstel van Tableau Server is een back-upportfolio nodig dat uit drie componenten bestaat:

• Een back-upbestand van de opslagplaats en de data van het bestandsarchief. Dit bestand wordt gegenereerd door de opdracht tsm maintenance backup.
• Een exportbestand met topologie en configuratie. Dit bestand wordt gegenereerd door de opdracht tsm settings export.
• Verificatiecertificaat, sleutel en keytab-bestanden.

Zie het Tableau Server-onderwerp Een volledige back-up maken van Tableau Server en Tableau Server herstellen (Linux(Link wordt in een nieuw venster geopend)) voor een volledige beschrijving van het back-up- en herstelproces.

In deze fase van uw implementatie worden alle relevante bestanden en assets die nodig zijn voor een volledig herstel opgenomen door de opdrachten tsm maintenance backup en tsm settings export uit te voeren.

1. Voer de volgende opdracht uit om de configuratie- en topologie-instellingen te exporteren naar een bestand met de naam ts_settings_backup.json.

   tsm settings export -f ts_settings_backup.json

2. Voer de volgende opdracht uit om een back-up te maken van de opslagplaats en de data van het bestandsarchief in een bestand met de naam ts_backup-<yyyy-mm-dd>.tsbak. Negeer de waarschuwing dat het bestandsarchief zich niet op het controller-knooppunt bevindt.

   tsm maintenance backup -f ts_backup -d --skip-compression

   Locatie van back-upbestand:

   /data/tableau_data/data/tabsvc/files/backups/

3. Kopieer beide bestanden en sla ze op een ander opslagmiddel op dat niet wordt gedeeld met uw Tableau Server-implementatie.