Installare Tableau Server con Gateway indipendente

Questo argomento illustra il processo di installazione di Gateway indipendente Tableau Server.

Seguendo questo processo si otterrà una configurazione di Gateway indipendente con una connessione diretta alla distribuzione di Tableau Server di back-end. Per saperne di più sulle modalità di connessione diretta e di inoltro, consulta l’argomento Configurare Tableau Server con Gateway indipendente.

Prerequisiti

  • Devi disporre di un server dedicato con almeno 2 core (4 vCPU), 8 GB di RAM e 100 GB di spazio libero su disco.
  • Devi usare Tableau Server 2022.1 o versione successiva.
  • Devi usare un programma di installazione di Gateway indipendente Tableau Server la cui versione principale (ad esempio 2022.1) corrisponde alla versione di Tableau Server. Raccomandiamo di verificare che anche le versioni di manutenzione (ad esempio 2022.1.1 o 2022.1.5) corrispondano, anche se questo non è un requisito. Se le "risorse statiche" cambiano tra le versioni e le versioni non corrispondono, potreste notare un impatto imprevisto sull’immagine. Ad esempio, le mappe potrebbero non essere aggiornate se il gateway indipendente è una versione precedente a quella di Tableau Server.
  • Devi avere una licenza Advanced Management valida attivata in Tableau Server. Per maggiori informazioni su Advanced Management, consulta Informazioni su Tableau Advanced Management su Tableau Server.
  • Per impostazione predefinita, il gateway indipendente deve essere in grado di comunicare con la distribuzione back-end di Tableau Server sulle porte 80 e 21319 durante l’installazione. È possibile cambiare queste porte predefinite durante l’inizializzazione come descritto più avanti in questo argomento.
  • Verificate che la distribuzione di Tableau Server sia completa e integra prima di installare e configurare il gateway indipendente.
  • Verifica di non eseguire altre applicazioni web-aware sul computer in cui stai installando il gateway indipendente. Ad esempio, se nel computer è installato Apache httpd, disinstallato o configura httpd in modo che non sia in ascolto attivo sulla porta 80.

Installare Tableau Server e Gateway indipendente

L’installazione di Gateway indipendente viene eseguita utilizzando un programma di installazione autonomo che include "tsig" come parte del nome del file per distinguerlo dal programma di installazione completo di Tableau Server. È consigliabile installare Gateway indipendente dopo aver installato Tableau Server e aver verificato che funzioni come previsto. Per eseguire l’installazione, devi avere i diritti di amministratore. È possibile installare una o più istanze di Gateway indipendente, ma ciascuna istanza deve essere installata separatamente. Se stai installando più istanze per la disponibilità elevata o per distribuire un carico client elevato, ripeti la procedura di installazione per ciascuna istanza.

Durante l’installazione, viene eseguito uno script denominato initialize-tsig.bat. Lo script richiede le informazioni necessarie per configurare Gateway indipendente. Una volta che Gateway indipendente è completamente installato, devi eseguire un comando TSM sul nodo iniziale di Tableau Server per configurare il server con i dettagli sull’istanza di Gateway indipendente.

L’installazione di Gateway indipendente comprende queste fasi:

  • Esegui il programma di installazione specifico della piattaforma.

  • Esegui lo script di post-installazione. Questa operazione viene eseguita automaticamente dal programma di installazione.

  • Abilita l’istanza di Gateway indipendente utilizzando TSM.

Fase 1. Scaricare e installare Tableau Server

  1. Installare TSM: segui le istruzioni fornite in questa sezione e completa i passaggi 1-5 per eseguire il programma di installazione e installare TSM.

  2. Attivare e registrare Tableau Server: fornisci la chiave di Tableau Server e la chiave di Advanced Management nel passaggio di attivazione. Dovrai eseguire il comando indicato di seguito due volte: la prima con il codice prodotto di Tableau Server, la seconda con il codice prodotto di Advanced Management:

    tsm licenses activate -k <product key>

  3. Configurare le impostazioni iniziali dei nodi: segui le istruzioni fornite in questa sezione per configurare le impostazioni iniziali dei nodi.

Fase 2. Scaricare e installare Gateway indipendente

Dopo aver scaricato il file di Gateway indipendente Tableau Server, segui le istruzioni riportate di seguito per installare Gateway indipendente.

  1. Nel computer in cui stai installando Gateway indipendente, accedi come utente con accesso di amministratore e fai doppio clic sul file di installazione scaricato.

  2. Nella prima schermata devi accettare il contratto di licenza prima di continuare.

  3. Dopo aver accettato il contratto di licenza, puoi eseguire una delle due azioni seguenti:

    • Installa Gateway indipendente facendo clic su Installa
      oppure
    • Modifica il percorso di installazione facendo clic su Personalizza, quindi installa Gateway indipendente:

      Per impostazione predefinita, Gateway indipendente viene installato in C:\Program Files\Tableau\Tableau Server\independentgateway. Puoi scegliere una posizione non predefinita, inclusa un’unità diversa, sia sfogliando le cartelle che digitando un nuovo percorso.

      Dopo aver specificato il percorso di installazione, fai clic su Installa per installare Gateway indipendente in questo percorso.

  4. Il programma di installazione installa Gateway indipendente ed esegue automaticamente lo script initialize-tsig.bat.

    In una finestra di comando aperta dal programma di installazione vengono richiesti i valori utilizzati per la configurazione di Gateway indipendente:

    • TSIG_TS_CLUSTER - Obbligatorio. Non esiste un valore predefinito. Devi immettere un valore quando richiesto.

      Dovrebbe essere l’indirizzo o gli indirizzi Internet di ogni nodo nel cluster Tableau Server. È possibile utilizzare caratteri jolly e subnet mask per specificare più nodi. Per specificare più indirizzi, separa gli indirizzi con spazi. I valori devono essere forniti in una delle forme accettabili per la direttiva "Require" di Apache httpd mod_authz_host. Per maggiori informazioni, consulta https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(Il collegamento viene aperto in una nuova finestra).

    • TSIG_HK_PORT - L’impostazione predefinita è 21319. Questa è la porta utilizzata per le richieste Housekeeping in arrivo da Tableau Server.
    • TSIG_HK_PROTOCOL - L’impostazione predefinita è http. I valori validi sono http e https. Questo è il protocollo utilizzato per le richieste di pulizia provenienti da Tableau Server.
    • TSIG_PORT - L’impostazione predefinita è 80. La porta utilizzata per le richieste esterne.
    • TSIG_PROTOCOL - L’impostazione predefinita è http. I valori validi sono http e https. Questo è il protocollo usato per le richieste esterne.
    • TSIG_INSTANCE_ID - Per impostazione predefinita è il nome del computer. Un identificatore univoco per l’istanza di Gateway indipendente.
  5. L’installazione termina al termine dell’esecuzione dello script e l’inizializzazione di Gateway indipendente.

Fase 3. Abilitare Gateway indipendente in Tableau Server

L’ultimo passaggio dell’installazione e della configurazione di Gateway indipendente consiste nell’abilitare Gateway indipendente in Tableau Server. A tale scopo, utilizza il comando TSM tsm topology external-services gateway enable -c <file> con un file JSON che identifica l’istanza o le istanze di Gateway indipendente e fornisce a Tableau Server i dettagli necessari per la comunicazione tra il server e Gateway indipendente.

Tableau Server deve essere in stato di arresto per abilitare Gateway indipendente.

Il contenuto del file JSON di Gateway indipendente

Il file JSON che utilizzi per abilitare le istanze di Gateway indipendente su Tableau Server deve contenere quanto segue:

  • id: il valore id deve corrispondere a TSIG_INSTANCE_ID per l’istanza particolare. Se non l’hai fornito durante l’inizializzazione, il valore predefinito è il nome (%COMPUTERNAME%) del computer Gateway indipendente. Il valore nel file json deve corrispondere all’output del comando hostname.
  • host: l’host deve essere un nome risolvibile tramite DNS del computer Gateway indipendente.
  • port: la porta deve corrispondere al valore TSIG_HK_PORT specificato nell’istanza di Gateway indipendente. Se non l’hai fornito durante l’inizializzazione, l’impostazione predefinita è "21319".
  • protocol: il protocollo deve corrispondere a TSIG_HK_PROTOCOL specificato nell’istanza di Gateway indipendente. Se non l’hai fornito durante l’inizializzazione, l’impostazione predefinita è "http".
  • authsecret: il segreto di autenticazione deve corrispondere al segreto creato dallo script di inizializzazione sull’istanza di Gateway indipendente.

Il segreto di autenticazione del Gateway indipendente

Lo script di inizializzazione crea un segreto univoco e condiviso su ogni computer Gateway indipendente. Hai bisogno di questo segreto per abilitare Gateway indipendente in Tableau Server. Copia il segreto e includilo nel tuo file JSON come "authsecret".

Il segreto condiviso si trova nel file tsighk-auth.conf qui:

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

Esempio di file JSON di Gateway indipendente

Il file JSON dovrebbe essere nel formato seguente. Questo file JSON di esempio mostra dove sono presenti i valori predefiniti. Il tuo file dovrebbe utilizzare i valori effettivi che corrispondono alla specifica installazione di Gateway indipendente e alla tua organizzazione.

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

Abilitazione di Gateway indipendente in Tableau Server

Per completare l’installazione di Gateway indipendente, è necessario abilitarlo tramite TSM.

  1. Copia il file di configurazione JSON nel nodo iniziale di Tableau Server.
  2. Sul nodo iniziale, apri un prompt dei comandi come amministratore.
  3. Esegui i seguenti comandi per arrestare Tableau Server, abilitare Gateway indipendente utilizzando il file di configurazione json e riavviare il server:

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

Fase 4. Verifica di Gateway indipendente in Tableau Server

Dovresti essere in grado di accedere alla pagina di accesso di Tableau Server inserendo l’indirizzo di Gateway indipendente in un browser.

Se è presente un firewall tra Gateway indipendente e la distribuzione back-end di Tableau Server, dovrai aprire le porte per i processi di Tableau Server per la connessione diretta. Per ulteriori informazioni, consulta Connessione diretta.

In alternativa, puoi scegliere di ridurre al minimo i requisiti delle porte configurando Gateway indipendente per una connessione di inoltro. Per maggiori informazioni, consulta Collegamento di inoltro.

Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!