Guida di Tableau Server su Linux

L’installazione di Gateway indipendente comprende queste fasi:

• Esegui il programma di installazione specifico della piattaforma.

• Esegui lo script di post-installazione.

• Abilita l’istanza di Gateway indipendente utilizzando TSM.

Installa Gateway indipendente Tableau Server con il gestore di pacchetti della distribuzione, quindi esegui uno script per inizializzare Gateway indipendente. Lo script è incluso nel pacchetto installato.

Gateway indipendente è installato nella directory /opt.

1. Accedi come utente con accesso sudo al computer in cui desideri installare Gateway indipendente.

   Nota: per evitare possibili complicazioni, è consigliabile utilizzare un account utente che non contenga caratteri speciali (ad esempio, caratteri non ASCII, "+", "-"). Questi caratteri possono causare problemi, inclusa l’impossibilità di installare completamente Gateway indipendente, a seconda della configurazione dell’ambiente.

2. Scarica il pacchetto del programma di installazione .rpm o .deb dalla pagina Scarica Tableau Server e note sulla versione.

3. Passa alla directory in cui hai copiato il pacchetto .rpm o .deb.

4. Utilizza il gestore di pacchetti per installare Gateway indipendente.

   Non eseguire l’installazione in una posizione utilizzando un collegamento simbolico o in una directory in un volume NFS (Network File System). Esegui questi comandi per installare Gateway indipendente, dove <version> è nel formato principale-secondaria-manutenzione (ad esempio, 2022-1-0).

   • Nelle distribuzioni di tipo RHEL, tra cui CentOS:

     sudo yum update

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

   • Su Ubuntu:

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

Inizializzare il Gateway indipendente Tableau Server

La fase successiva è eseguire lo script initialize-tsig.

1. Passa alla directory scripts:

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

2. Esegui lo script seguente per inizializzare e avviare Gateway indipendente:

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

   Gli unici parametri richiesti per lo script initialize-tsig sono --accepteula e -c.

   • --accepteula - Devi includere questo parametro per accettare il Contratto di licenza per l’utente finale (EULA) di Tableau Server. Un collegamento al Contratto di licenza è disponibile al seguente indirizzo:

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

   • -c - È necessario includere questo parametro per specificare la posizione di rete di tutti i nodi nel cluster Tableau Server. Questi nodi potrebbero inviare richieste di "pulizia" a Gateway indipendente. È possibile utilizzare caratteri jolly e subnet mask per specificare più nodi. Per specificare più indirizzi, separa gli indirizzi con spazi e utilizza le virgolette intorno all’insieme completo. 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).

   Tutti gli altri parametri, ad esempio le porte predefinite utilizzate da HTTP e il processo Housekeeping, sono facoltativi. Se non sono specificati, verranno assegnati i valori predefiniti. Esamina i parametri e i relativi valori predefiniti prima di eseguire lo script: Guida di output per lo script initialize-tsig.

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 specificato, l’impostazione predefinita è il nome di dominio completo del computer Gateway indipendente, in minuscolo. Il valore nel file json deve corrispondere all’output del comando hostname.
• host: il valore host deve essere un nome risolvibile tramite DNS per il computer Gateway indipendente che può essere risolto dai nodi Tableau Server che utilizzano DNS.
• porta: la porta deve corrispondere alla porta di Housekeeping (tsig_housekeeping_port) specificato nell’istanza di Gateway indipendente. Se non l’hai fornito durante l’inizializzazione, l’impostazione predefinita è "21319".
• protocollo: il protocollo deve essere lo stesso del protocollo Housekeeping (tsig_housekeeping_port_protocol) specificato nell’istanza di Gateway indipendente. Se non l’hai fornito durante l’inizializzazione, l’impostazione predefinita è "http".
• authsecret: authsecret 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:

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

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 con un account che è un membro del gruppo tsmadmin.

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