Deel 4 – Tableau Server installeren en configureren

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.

Voordat u begint

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

PostgreSQL installeren, configureren en tarren

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.

PostgreSQL-revisiegeschiedenis

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

Tableau Server-versiesMinimaal compatibele versies van PostgreSQL
2021.2.3 - 2021.2.8

2021.3.0 - 2021.3.7

2021.4.0 - 2021.4.3

12.6
2021.2.10 - 2021.2.14

2021.3.8 - 2021.3.13

2021.4.4 - 2021.4.8

12.8
2021.2.15 - 2021.2.16

2021.3.14 - 2021.3.15

2021.4.9 - 2021.4.10

12.10
2021.2.17 - 2021.2.18

2021.3.16 - 2021.3.17

2021.4.11 - 2021.4.12

12.11
2021.3.26

2021.4.23

12.15
2022.1.013.3
2022.1.1 - 2022.1.313.4
2022.1.4 - 2022.1.613.6
2022.1.7 - 2022.1.16

2022.3.0 - 2022.3.7

2023.1.0 - 2023.1.4

13.7
2022.1.17 - 2022.1.19

2022.3.8 - 2022.3.11

2023.1.5 - 2023.1.7

2023.3.0 - 2023.3.3

13.11

PostgreSQL installeren

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

Postgres configureren

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

Tar-back-up van PostgreSQL Stap 1 maken

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

Herstel Stap 1

Ga terug naar stap 1 als het eerste knooppunt van Tableau Server tijdens de installatie uitvalt.

  1. Voer op de computer waarop Tableau draait het vernietigingsscript uit om Tableau Server volledig van de host te verwijderen:

    sudo /app/tableau_server/packages/scripts.<version_code>/./tableau-server-obliterate -a -y -y -y -l

  2. Herstel de tar van PostgreSQL Stap 1. Voer de volgende opdrachten uit op de computer waarop Postgres draait:

    sudo su
    systemctl stop postgresql-13
    cd /var/lib/pgsql
    tar  -xvf step1.13.bkp.tar
    systemctl start postgresql-13
    exit

Hervat het installatieproces van het eerste knooppunt van Tableau Server.

Voor de installatie

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.

Het eerste knooppunt van Tableau Server installeren

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.

Het installatiepakket uitvoeren en TSM initialiseren

Meld u aan bij de hostserver van Knooppunt 1.

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

    sudo yum update

  2. Kopieer het installatiepakket van Tableau-downloadpagina(Link wordt in een nieuw venster geopend) naar de hostcomputer waarop Tableau Server wordt uitgevoerd.

    Voer bijvoorbeeld op een computer met een Linux RHEL-achtig besturingssysteem het volgende uit:

    wget https://downloads.tableau.com/esdalt/2022<version>/tableau-server-<version>.rpm

    waarbij <version> het releasenummer is.

  3. Download en installeer afhankelijkheden:

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

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

    sudo mkdir -p /app/tableau_server

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

  6. Wijzig naar de directory /app/tableau_server/packages/scripts.<version_code>/ en voer het initialize-tsm-script dat zich daar bevindt uit:

    sudo ./initialize-tsm -d /data/tableau_data --accepteula

  7. Nadat de initialisatie is voltooid, verlaat u de shell:

    exit

Tableau Server activeren en registreren

  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

Het identiteitenarchief configureren

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

Externe Postgres configureren

  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.

De installatie van Knooppunt 1 afronden

  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.

Verificatie: configuratie van Knooppunt 1

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

Tar-back-ups van Stap 2 maken

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.

Tar-bestanden van Stap 2 maken
  1. Stop Tableau op het eerste knooppunt van Tableau:

    tsm stop

    Wacht tot Tableau stopt voordat u doorgaat naar de volgende stap.

  2. Stop de PostgreSQL-database-instantie op de PostgreSQL-host:

    sudo systemctl stop postgresql-13

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

    sudo su
    cd /var/lib/pgsql
    tar -cvf step2.13.bkp.tar 13
    exit
  4. Controleer of het Postgres-tar-bestand is gemaakt met root-machtigingen:

    sudo ls -al /var/lib/pgsql

  5. Stop de Tableau-beheerservices op de Tableau-host:

    sudo /app/tableau_server/packages/scripts.<version_code>/./stop-administrative-services
  6. Voer de volgende opdrachten uit om de tar-back-up te maken:

    cd /data
    sudo tar -cvf step2.tableau_data.bkp.tar tableau_data	
  7. Start de Postgres-database op de Postgres-host:

    sudo systemctl start postgresql-13

  8. Start Tableau-beheerservices:

    sudo /app/tableau_server/packages/scripts.<version_code>/./start-administrative-services
  9. Voer de opdracht tsm status uit om de TSM-status te controleren voordat u opnieuw opstart.

    In de meeste gevallen retourneert de opdracht eerst de status GEDEGRADEERD of FOUT. Wacht een paar minuten en voer de opdracht dan opnieuw uit. Als de status FOUT of GEDEGRADEERD wordt geretourneerd, wacht u nog wat langer. Probeer TSM niet te starten voordat de status GESTOPT wordt geretourneerd. Voer vervolgens de volgende opdracht uit:

    tsm start

Herstel Stap 2

Met dit proces worden Tableau Knooppunt 1 en de Postgres-instantie teruggezet naar Stap 2. Nadat u deze stap hebt hersteld, kunt u de resterende Tableau Knooppunten opnieuw implementeren.

  1. Stop de tsm-services op de eerste Tableau-host (Knooppunt 1):

    tsm stop

  2. Stop de beheerservices van Tableau op alle knooppunten van de Tableau Server-implementatie. Voer de volgende opdracht uit op elk knooppunt, in de juiste volgorde (Knooppunt 1, Knooppunt 2 en vervolgens Knooppunt 3):

    sudo /app/tableau_server/packages/scripts.<version_code>/./stop-administrative-services
  3. Nadat de Tableau-services zijn gestopt, herstelt u de PostgreSQL-tar van Stap 2. Voer de volgende opdrachten uit op de computer waarop Postgres draait:

    • sudo su
      systemctl stop postgresql-13
      cd /var/lib/pgsql
      tar  -xvf step2.13.bkp.tar
      systemctl start postgresql-13
      exit
  4. Herstel de Tableau-tar van Stap 2. Voer de volgende opdrachten uit op de initiële Tableau-host:

    cd /data
    sudo rm -rf tableau_data
    sudo tar  -xvf step2.tableau_data.bkp.tar
  5. Verwijder de volgende bestanden op de Tableau Knooppunt 1-computer:

    • sudo rm /data/tableau_data/data/tabsvc/appzookeeper/0/version-2/currentEpoch
    • sudo rm /data/tableau_data/data/tabsvc/appzookeeper/0/version-2/acceptedEpoch
    • sudo rm /data/tableau_data/data/tabsvc/tabadminagent/0/servicestate.json
  6. Start de Tableau-beheerservices:

    sudo /app/tableau_server/packages/scripts.<version_code>/./start-administrative-services

  7. Laad de Tableau systmctl-bestanden opnieuw en voer vervolgens start-administrative-services opnieuw uit:

    sudo su -l tableau -c "systemctl --user daemon-reload"

    sudo /app/tableau_server/packages/scripts.<version_code>/./start-administrative-services

  8. Voer op Knooppunt 1 de opdracht tsm status uit om de TSM-status te controleren voordat u opnieuw opstart.

    In sommige gevallen krijgt u een foutmelding Cannot connect to server.... Deze fout treedt op omdat de tabadmincontroller-service niet opnieuw is opgestart. Blijf tsm status met tussenpozen uitvoeren. Als deze fout na 10 minuten niet verdwijnt, voer dan de opdracht start-administrative-services opnieuw uit.

    U moet even wachten en dan retourneert de opdracht tsm status de status GEDEGRADEERD en vervolgens FOUT. Start TSM pas als de status GESTOPT wordt geretourneerd. Voer vervolgens de volgende opdracht uit:

    tsm start

Hervat het installatieproces om Tableau Server op de resterende knooppunten te installeren.

Tableau Server op de resterende knooppunten installeren

Kopieer het Tableau-installatieprogramma naar elk knooppunt om de implementatie voort te zetten.

Overzicht van knooppuntconfiguratie

In deze sectie wordt het proces voor het configureren van Knooppunten 2 tot 4 beschreven. In de volgende secties vindt u gedetailleerde configuratie- en validatieprocedures voor elke stap.

Voor de installatie van Tableau Server Knooppunten 2 tot 4 moet u tijdens de installatie van het knooppunt een bootstrap-bestand genereren, kopiëren en eraan refereren.

Om het bootstrap-bestand te genereren, voert u een TSM-opdracht uit op het eerste knooppunt. Vervolgens kopieert u het bootstrap-bestand naar het doelknooppunt, waar u het uitvoert als onderdeel van de knooppuntinitialisatie.

De volgende json-inhoud toont een voorbeeld van een bootstrap-bestand. (De certificaat- en cryptogerelateerde waarden zijn afgekapt om het voorbeeldbestand beter leesbaar te maken.)

{
"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"
	}
}

Het bootstrap-bestand bevat verbindingsgebaseerde validatie om Knooppunt 1 te verifiëren en creëert een versleuteld kanaal voor het bootstrap-proces. De bootstrap-sessie is tijdsgebonden en het configureren en valideren van knooppunten kost veel tijd. Houd er rekening mee dat u nieuwe bootstraps moet maken en kopiëren terwijl u de knooppunten configureert.

Nadat u het bootstrap-bestand hebt uitgevoerd, meldt u zich aan bij het eerste Tableau Server-knooppunt en configureert u de processen voor het nieuwe knooppunt. Wanneer u klaar bent met het configureren van de knooppunten, moet u de wijzigingen toepassen en het eerste knooppunt opnieuw opstarten. Het nieuwe knooppunt is geconfigureerd en gestart. Naarmate u meer knooppunten toevoegt, duurt het langer om de configuratie en het opnieuw opstarten van de implementatie te voltooien.

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

Het bootstrap-bestand genereren, kopiëren en gebruiken om TSM te initialiseren

De volgende procedure laat zien hoe u een bootstrap-bestand genereert, kopieert en gebruikt bij het initialiseren van TSM op een ander knooppunt. In dit voorbeeld heet het bootstrap-bestand boot.json.

In dit voorbeeld draaien de hostcomputers op AWS, terwijl de EC2-hosts op Amazon Linux 2 draaien.

  1. Maak verbinding met het eerste knooppunt (Knooppunt 1) en voer de volgende opdracht uit:

    tsm topology nodes get-bootstrap-file --file boot.json

  2. Kopieer het bootstrap-bestand naar Knooppunt 2.

    scp boot.json ec2-user@10.0.31.83:/home/ec2-user/

  3. Maak verbinding met Knooppunt 2 en schakel over naar de scriptsdirectory van Tableau Server:

    cd /app/tableau_server/packages/scripts.<version_number>

  4. Voer de opdracht initialize-tsm uit en refereer aan het bootstrap-bestand:

    sudo ./initialize-tsm -d /data/tableau_data -b /home/ec2-user/boot.json --accepteula

  5. Nadat initialize-tsm is voltooid, verwijdert u boot.json en sluit vervolgens de sessie af of log uit.

Processen configureren

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.

Knooppunt 2 configureren

  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

Knooppunt 3 configureren

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

Coördinatieservice-ensemble implementeren op Knooppunten 1 tot 3

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

Tar-back-ups van Stap 3 maken

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

  • PostgreSQL
  • Tableau eerste knooppunt (Knooppunt 1)
  • Tableau-knooppunt 2
  • Tableau-knooppunt 3
Tar-bestanden van Stap 3 maken
  1. Stop Tableau op het eerste knooppunt van Tableau:

    tsm stop

  2. Nadat TSM is gestopt, stopt u de beheerservices van Tableau op elk knooppunt. Voer de volgende opdracht uit op elk knooppunt, in de juiste volgorde (Knooppunt 1, Knooppunt 2 en vervolgens Knooppunt 3):

    sudo /app/tableau_server/packages/scripts.<version_code>/./stop-administrative-services

  3. Stop de PostgreSQL-database-instantie op de PostgreSQL-host:

    sudo systemctl stop postgresql-12

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

    sudo su
    cd /var/lib/pgsql
    tar -cvf step3.12.bkp.tar 12
    exit
  5. Controleer of het Postgres-tar-bestand is gemaakt met root-machtigingen:

    sudo ls -al /var/lib/pgsql

  6. Start de Postgres-database op de Postgres-host:

    sudo systemctl start postgresql-12

  7. Maak de tar-back-up op Knooppunt 1, Knooppunt 2 en Knooppunt 3. Voer de volgende opdrachten uit op elk knooppunt:

    • cd /data
      sudo tar -cvf step3.tableau_data.bkp.tar tableau_data
    • Controleer of het Tableau-tar-bestand is gemaakt met root-machtigingen:

      ls -al

  8. Start Tableau-beheerservices op elk knooppunt, in de juiste volgorde (Knooppunt 1, Knooppunt 2 en vervolgens Knooppunt 3):

    sudo /app/tableau_server/packages/scripts.<version_code>/./start-administrative-services

  9. Voer de opdracht tsm status uit om de TSM-status te controleren voordat u opnieuw opstart.

    In de meeste gevallen retourneert de opdracht de status GEDEGRADEERD en daarna FOUT. Wacht even en voer de opdracht dan opnieuw uit. Als de status FOUT of GEDEGRADEERD wordt geretourneerd, wacht u nog wat langer. Probeer TSM niet te starten voordat de status GESTOPT wordt geretourneerd. Voer vervolgens de volgende opdracht uit:

    tsm start

Herstel Stap 3

Dit proces herstelt Tableau Knooppunt 1, Knooppunt 2 en Knooppunt 3. Het herstelt ook het Postgres-exemplaar naar Stap 3. Nadat u deze stap hebt hersteld, kunt u de coördinatieservice, Knooppunt 4 en de definitieve knooppuntconfiguraties implementeren.

  1. Stop de tsm-service op de eerste Tableau-host (Knooppunt 1):

    tsm stop

  2. Nadat TSM is gestopt, stopt u de beheerservices van Tableau op Knooppunt 1, Knooppunt 2 en Knooppunt 3. Voer de volgende opdracht uit op elk knooppunt:

    sudo /app/tableau_server/packages/scripts.<version_code>/./stop-administrative-services

  3. Herstel de PostgreSQL-tar van Stap 3. Voer de volgende opdrachten uit op de computer waarop Postgres draait:

    sudo su
    systemctl stop postgresql-12
    cd /var/lib/pgsql
    tar -xvf step3.12.bkp.tar
    systemctl start postgresql-12
    exit
  4. Herstel de Tableau-tar van Stap 3 op Knooppunt 1, Knooppunt 2 en Knooppunt 3. Voer de volgende opdrachten uit op elk Tableau-knooppunt:

    cd /data
    sudo rm -rf tableau_data
    sudo tar  -xvf step3.tableau_data.bkp.tar
  5. Verwijder de volgende bestanden op de Tableau Knooppunt 1-computer:

    • sudo rm /data/tableau_data/data/tabsvc/appzookeeper/1/version-2/currentEpoch
    • sudo rm /data/tableau_data/data/tabsvc/appzookeeper/1/version-2/acceptedEpoch
    • sudo rm /data/tableau_data/data/tabsvc/tabadminagent/0/servicestate.json

    Als de shell de foutmelding Bestand niet gevonden retourneert, moet u mogelijk de naam van het pad wijzigen om het nummer <n> te verhogen in deze sectie van het pad: .../appzookeeper/<n>/version-2/....

  6. Start de beheerservices op Knooppunt 1, Knooppunt 2 en Knooppunt 3 opnieuw. Voer de volgende opdrachten uit op elk knooppunt:

    sudo /app/tableau_server/packages/scripts.<version_code>/./start-administrative-services

    sudo su -l tableau -c "systemctl --user daemon-reload"

    sudo /app/tableau_server/packages/scripts.<version_code>/./start-administrative-services

  7. Voer op Knooppunt 1 de opdracht tsm status uit om de TSM-status te controleren voordat u opnieuw opstart.

    In sommige gevallen krijgt u een foutmelding Cannot connect to server.... Deze fout treedt op omdat de tabadmincontroller-service niet opnieuw is opgestart. Blijf tsm status met tussenpozen uitvoeren. Als deze fout na 10 minuten niet verdwijnt, voer dan de opdracht start-administrative-services opnieuw uit.

    U moet even wachten en dan retourneert de opdracht tsm status de status GEDEGRADEERD en vervolgens FOUT. Start TSM pas als de status GESTOPT is geretourneerd. Voer vervolgens de volgende opdracht uit:

    tsm start

Hervat het installatieproces om de coördinatieservice op Knooppunten 1 tot 3 te implementeren.

Knooppunt 4 configureren

Het proces voor het configureren van Knooppunt 4 is hetzelfde als voor Knooppunt 3.

Stel dezelfde processen in als die u voor Knooppunt 3 hebt ingesteld, voer dezelfde reeks opdrachten uit als hierboven, maar geef node4 op in de opdrachten in plaats van node3.

Net als bij de verificatie van Knooppunt 3, verifieert u de configuratie van Knooppunt 4 door tsm status -v uit te voeren.

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.

Definitieve procesconfiguratie en -verificatie

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.

Back-up uitvoeren

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.

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.