Help bij Tableau Server op Linux

De IG-installatie bestaat uit de volgende stappen:

• Voer het platformspecifieke installatieprogramma uit.

• Voer het script voor na de installatie uit.

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

Installeer onafhankelijke gateway van Tableau Server met de pakketbeheerder van uw distributie en voer vervolgens een script uit om onafhankelijke gateway te initialiseren. Het script is bij het geïnstalleerde pakket inbegrepen.

Onafhankelijke gateway wordt geïnstalleerd in de /opt-directory.

1. Meld u aan als gebruiker met sudo-toegang tot de computer waarop u onafhankelijke gateway wilt installeren.

   Opmerking: Om mogelijke complicaties te voorkomen, raden wij u aan een gebruikersaccount te gebruiken dat geen speciale tekens bevat (bijvoorbeeld niet-ASCII, '+', '-'). Deze tekens kunnen problemen veroorzaken, waaronder een mislukte volledige installatie van onafhankelijke gateway, afhankelijk van hoe uw omgeving is geconfigureerd.

2. Download het installatiepakket .rpm of .deb van de pagina Tableau Server-downloads en releaseopmerkingen.

3. Navigeer naar de directory waarnaar u het pakket .rpm of .deb hebt gekopieerd.

4. Gebruik de pakketbeheerder om onafhankelijke gateway te installeren.

   Installeer niet op een locatie met een symbolische link of in een map op een NFS-volume (Network File System). Voer de volgende opdrachten uit om onafhankelijke gateway te installeren, waarbij <version> is geformatteerd als groot-klein-onderhoud (bijvoorbeeld: 2022-1-0).

   • Op RHEL-achtige distributies, waaronder CentOS:

     sudo yum update

     sudo yum install tableau-tsig-<version>.x86_64.rpm

   • In Ubuntu:

     sudo apt-get update
     sudo apt-get upgrade
     sudo apt-get -y install gdebi-core
     sudo gdebi -n tableau-tsig-<version>_amd64.deb
     

Onafhankelijke gateway van Tableau Server initialiseren

De volgende stap is om het initialize-tsig-script uit te voeren.

1. Navigeer naar de scripts-directory:

   cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/

2. Voer het volgende script uit om onafhankelijke gateway te initialiseren en te starten:

   sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>

   De enige vereiste parameters voor het initialize-tsig-script zijn --accepteula en -c.

   • --accepteula - U moet deze parameter opnemen om de Licentieovereenkomst voor de eindgebruikers (EULA) te accepteren. Een link naar de EULA is beschikbaar op de volgende locatie:

     /opt/tableau/tableau_tsig/packages/docs.<version_code>/

   • -c - U moet deze parameter opnemen om de netwerklocatie van alle knooppunten in het Tableau Server-cluster op te geven. Deze knooppunten kunnen 'housekeeping'-verzoeken naar de onafhankelijke gateway sturen. U kunt jokertekens en subnetmaskers gebruiken om meerdere knooppunten op te geven. Als u meerdere adressen wilt opgeven, scheidt u de adressen door spaties en gebruikt u aanhalingstekens rondom de volledige set. Waarden moeten worden verstrekt 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.

   Alle andere parameters, bijvoorbeeld de standaardpoorten die worden gebruikt door HTTP en het housekeepingproces, zijn optioneel en krijgen standaardwaarden als u ze weglaat. Controleer de parameters en de bijbehorende standaardwaarden voordat u het script uitvoert: Help-uitvoer voor het script initialize-tsig.

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, wordt standaard de volledig gekwalificeerde domeinnaam van de onafhankelijke gateway-computer in kleine letters gebruikt. De waarde in het json-bestand moet overeenkomen met de uitvoer van de opdracht hostname.
• host—De hostwaarde moet een DNS-oplosbare naam zijn voor de onafhankelijke gateway-computer die kan worden opgelost door de Tableau Server-knooppunten die DNS gebruiken.
• port—De poort moet overeenkomen met de housekeepingpoort (tsig_housekeeping_port) opgegeven in de onafhankelijke gateway-instantie. Als u dit niet tijdens de initialisatie hebt opgegeven, is de standaardwaarde '21319'.
• protocol—Het protocol moet hetzelfde zijn als het housekeepingprotocol (tsig_housekeeping_port_protocol) 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:

/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf

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 met een account dat lid is van de tsmadmin-groep.

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