Tableau Server Installeren met onafhankelijke gateway

In dit onderwerp wordt het installatieproces van onafhankelijke gateway van Tableau Server beschreven.

Als u dit proces volgt, krijgt u een onafhankelijke gateway-configuratie met een directe verbinding met de backend van de Tableau Server-implementatie. U kunt meer leren over directe versus relayverbindingsmodi in het artikel Tableau Server configureren met onafhankelijke gateway.

Vereisten

  • U moet beschikken over een specifieke server met minimaal 2 kernen (4 vCPU's), 8 GB RAM en 100 GB vrije schijfruimte.
  • U moet Tableau Server 2022.1 of hoger gebruiken.
  • U moet een installatieprogramma voor de onafhankelijke gateway van Tableau Server gebruiken met een primaire versie (bijvoorbeeld 2022.1) die overeenkomt met de versie van Tableau Server. Wij raden ook overeenkomstige onderhoudsversies (bijvoorbeeld 2022.1.1 of 2022.1.5) aan, maar dit is geen vereiste. Als 'statische assets' tussen versies veranderen en versies niet overeenkomen, kan dit onverwachte gevolgen hebben voor de installatiekopie. Kaarten zijn bijvoorbeeld mogelijk niet up-to-date als de onafhankelijke gateway een eerdere versie is dan Tableau Server.
  • U moet een geldige Advanced Management-licentie geactiveerd hebben in Tableau Server. Zie Over Tableau Advanced Management in Tableau Server voor meer informatie over Advanced Management.
  • Standaard moet de onafhankelijke gateway tijdens de installatie kunnen communiceren met de backend Tableau Server-implementatie op poorten 80 en 21319. U kunt deze standaardpoorten tijdens de initialisatie wijzigen, zoals later in dit onderwerp wordt beschreven.
  • Controleer of uw Tableau Server-implementatie voltooid en in orde is voordat u de onafhankelijke gateway installeert en configureert.
  • Controleer of er geen andere webtoepassingen actief zijn op de computer waarop u de onafhankelijke gateway installeert. Als Apache httpd bijvoorbeeld op de computer is geïnstalleerd, moet u het verwijderen of httpd configureren zodat er niet actief geluisterd wordt op poort 80.

Tableau Server en onafhankelijke gateway installeren

Het installeren van onafhankelijke gateway gebeurt via een stand-alone installatieprogramma waarbij 'tsig' deel uitmaakt van de bestandsnaam om het te onderscheiden van het volledige Tableau Server-installatieprogramma. Wij raden u ten zeerste aan om onafhankelijke gateway te installeren nadat u Tableau Server hebt geïnstalleerd en hebt gecontroleerd of deze naar behoren functioneert. Om te installeren moet u beheerdersrechten hebben, . U kunt één of meerdere instanties van onafhankelijke gateway installeren, maar elke instantie van onafhankelijke gateway moet afzonderlijk worden geïnstalleerd. Als u meerdere instanties installeert voor hoge beschikbaarheid of om een zware clientbelasting te verdelen, herhaalt u de installatiestappen voor elke instantie.

Tijdens de installatie wordt een script met de naam initialize-tsig.bat uitgevoerd. Het script vraagt u om de informatie die nodig is om onafhankelijke gateway te configureren. Zodra onafhankelijke gateway volledig is geïnstalleerd, moet u een TSM-opdracht uitvoeren op het eerste knooppunt van Tableau Server om de server te configureren met details over de instantie van onafhankelijke gateway.

De IG-installatie bestaat uit de volgende stappen:

  • Voer het platformspecifieke installatieprogramma uit.

  • Voer het script voor na de installatie uit. Dit gebeurt automatisch door het configuratieprogramma.

  • Schakel de onafhankelijke gateway-instantie in met behulp van TSM.

Stap 1: Tableau Server downloaden en installeren

  1. TSM installeren: volg de instructies in dit artikel en voltooi stap 1-5. Hiermee wordt het installatieprogramma uitgevoerd en TSM geïnstalleerd.

  2. Tableau Server activeren en registreren: geef de Tableau Server-sleutel en de Advanced Management-sleutel op tijdens de activeringsstap. U moet de volgende opdracht twee keer uitvoeren, eerst met de productcode van Tableau Server en vervolgens met de Advanced Management-productcode:

    tsm licenses activate -k <product key>

  3. Initiële knooppuntinstellingen configureren: volg de instructies in het artikel om de initiële knooppuntinstellingen te configureren.

Stap 2: onafhankelijke gateway downloaden en installeren

Nadat u het installatiebestand van onafhankelijke gateway van Tableau Server hebt gedownload, volgt u de onderstaande instructies om onafhankelijke gateway te installeren.

  1. Meld u aan als gebruiker met beheerdersrechten op de computer waarop u onafhankelijke gateway installeert en dubbelklik op het gedownloade installatiebestand.

  2. Op het eerste scherm moet u de licentieovereenkomst accepteren voordat u verder kunt gaan.

  3. Nadat u de licentieovereenkomst hebt geaccepteerd, kunt u twee acties ondernemen:

    • installeer onafhankelijke gateway door te klikken op Installeren;
      of
    • wijzig de installatielocatie door te klikken op Aanpassen en installeer vervolgens onafhankelijke gateway:

      standaard wordt onafhankelijke gateway geïnstalleerd in C:\Program Files\Tableau\Tableau Server\independentgateway. U kunt een niet-standaard locatie kiezen, inclusief een andere schijf, door naar een nieuw pad te bladeren of dit te typen.

      Nadat u de installatielocatie hebt opgegeven, klikt u op Installeren om de onafhankelijke gateway op deze locatie te installeren.

  4. Het installatieprogramma installeert onafhankelijke gateway en voert automatisch het initialize-tsig.bat-script uit.

    In een opdrachtvenster dat door het installatieprogramma wordt geopend, wordt u gevraagd waarden in te voeren die worden gebruikt voor het configureren van onafhankelijke gateway:

    • TSIG_TS_CLUSTER—Vereist. Er is geen standaardwaarde. U moet een waarde invoeren wanneer u erom wordt gevraagd.

      Dit zou het internetadres of de internetadressen van elk knooppunt in het Tableau Server-cluster moeten zijn. U kunt jokertekens gebruiken en subnetmaskers gebruiken om meerdere knooppunten op te geven. Als u meerdere adressen wilt opgeven, scheidt u de adressen met spaties. Waarden moeten worden opgegeven in een van de vormen die acceptabel zijn voor de Apache httpd mod_authz_host 'Require'-adressering. Zie https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(Link wordt in een nieuw venster geopend) (in het Engels) voor meer informatie.

    • TSIG_HK_PORT—Standaard is 21319. Dit is de poort die wordt gebruikt voor binnenkomende housekeeping-aanvragen van Tableau Server.
    • TSIG_HK_PROTOCOL—Standaard is http. Geldige waarden zijn http en https. Dit is het protocol dat wordt gebruikt voor housekeeping-verzoeken van Tableau Server.
    • TSIG_PORT—Standaard is 80. De poort die wordt gebruikt voor externe verzoeken.
    • TSIG_PROTOCOL— Standaard is http. Geldige waarden zijn http en https. Dit is het protocol dat wordt gebruikt voor externe verzoeken.
    • TSIG_INSTANCE_ID—Standaard is dit de machinenaam. Een unieke identificatie voor de instantie van de onafhankelijke gateway.
  5. De installatie is voltooid wanneer het script is uitgevoerd en onafhankelijke gateway is geïnitialiseerd.

Stap 3: Onafhankelijke gateway in Tableau Server inschakelen

De laatste stap bij het installeren en configureren van onafhankelijke gateway is het inschakelen van onafhankelijke gateway in Tableau Server. Gebruik hiervoor de TSM-opdracht tsm topology external-services gateway enable -c <file> met een JSON-bestand dat de onafhankelijke gateway-instantie(s) identificeert en Tableau Server de benodigde data voor communicatie tussen de server en de onafhankelijke gateway verstrekt.

Tableau Server moet gestopt zijn om onafhankelijke gateway in te kunnen schakelen.

Inhoud van het JSON-bestand van onafhankelijke gateway

Het JSON-bestand dat u gebruikt om de onafhankelijke gateway-instanties op Tableau Server in te schakelen, moet het volgende bevatten:

  • id—De id-waarde moet overeenkomen met de TSIG_INSTANCE_ID voor de specifieke instantie. Als u deze niet hebt opgegeven tijdens de initialisatie, is de standaardnaam de computernaam (%COMPUTERNAME%) van de onafhankelijke gateway-computer. De waarde in het json-bestand moet overeenkomen met de uitvoer van de opdracht hostname.
  • host—De host moet een DNS-oplosbare naam zijn van de onafhankelijke gateway-computer.
  • port—De poort moet overeenkomen met de TSIG_HK_PORT-waarde die is opgegeven in de onafhankelijke gateway-instantie. Als u dit niet tijdens de initialisatie hebt opgegeven, is de standaardwaarde '21319'.
  • protocol—Het protocol moet overeenkomen met de TSIG_HK_PROTOCOL die is opgegeven in de onafhankelijke gateway-instantie. Als u dit niet tijdens de initialisatie hebt opgegeven, is de standaardwaarde 'http'.
  • authsecret—Het verificatiegeheim moet overeenkomen met het geheim dat is gemaakt door het initialisatiescript voor de onafhankelijke gateway-instantie.

Het onafhankelijke gateway-verificatiegeheim

Het initialisatiescript creëert een uniek, gedeeld geheim op elke onafhankelijke gateway-computer. U hebt dit geheim nodig om onafhankelijke gateway in Tableau Server in te schakelen. Kopieer het geheim en neem het op in uw JSON-bestand als 'authsecret'.

Het gedeelde geheim bevindt zich in dit tsighk-auth.conf-bestand:

C:\ProgramData\Tableau\Tableau Server\independentgateway\config\tsighk-auth.conf

Voorbeeld van een JSON-bestand voor onafhankelijke gateway

Het JSON-bestand moet de onderstaande indeling hebben. In dit voorbeeld van een JSON-bestand worden standaardwaarden weergegeven waar standaardwaarden bestaan. Uw bestand moet de werkelijke waarden bevatten die overeenkomen met uw installatie van onafhankelijke gateway en uw organisatie.

{
"independentGateways": [ { "id": "<IGCOMPUTER>", "host": "<DNS name of Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret01>" }, { "id": "<IGCOMPUTER2>", "host": "<DNS name of second Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret02>" } ] }

Onafhankelijke gateway in Tableau Server inschakelen

Om de installatie van onafhankelijke gateway te voltooien, moet u deze inschakelen via TSM.

  1. Kopieer het JSON-configuratiebestand naar het eerste knooppunt van Tableau Server.
  2. Open op het eerste knooppunt een opdrachtprompt als beheerder.
  3. Voer de volgende opdrachten uit om Tableau Server te stoppen, onafhankelijke gateway in te schakelen met behulp van het JSON-configuratiebestand en de server opnieuw op te starten:

    tsm stop
    tsm topology external-services gateway enable -c tsig.json
    tsm start

Stap 4: Onafhankelijke gateway in Tableau Server verifiëren

U zou naar de aanmeldingspagina van Tableau Server moeten kunnen navigeren door het adres van de onafhankelijke gateway in een browser in te voeren.

Als er een firewall is tussen de onafhankelijke gateway en de backend van de Tableau Server-implementatie, moet u de poorten voor de Tableau Server-processen openen voor directe verbinding. Zie Directe verbinding voor meer informatie.

U kunt er ook voor kiezen om de poortvereisten te minimaliseren door een onafhankelijke gateway te configureren voor een relayverbinding. Zie Relayverbinding voor meer informatie.

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