Guida di Tableau Server su Linux

Il registro di installazione, app-install.logsi trova in /var/opt/tableau/tableau_server/logs.

Il registro di aggiornamento, app-upgrade.logsi trova in /var/opt/tableau/tableau_server/logs.

Tentativi di installazione multipli non riusciti

Se si tenta di installare Tableau Server e l’installazione ha esito negativo, è probabile che i tentativi di installazione successivi non vengano eseguiti correttamente a meno che non si esegua lo script tableau-server-obliterate per eliminare Tableau dal computer.

Un tentativo di installazione non riuscito può lasciare il computer in uno stato che causa l’esecuzione di tentativi successivi che a loro volta non riescono con errori che non sembrano direttamente correlati a un tentativo di installazione precedente. Un errore possibile è:

Enabling and starting all services
+ services=(appzookeeper* tabadmincontroller* tabsvc* licenseservice* fnplicenseservice* tabadminagent* clientfileservice*)
+ systemctl_user enable appzookeeper_0.service 'tabadmincontroller*' 'tabsvc*' 'licenseservice*' fnplicenseservice_0.service 'tabadminagent*' 'clientfileservice*'
++ id -ru a_tabadminpoc
+ local unprivileged_uid=222954
+ su -l a_tabadminpoc -c 'XDG_RUNTIME_DIR=/run/user/222954 systemctl --user enable appzookeeper_0.service tabadmincontroller* tabsvc* licenseservice* fnplicenseservice_0.service tabadminagent* clientfileservice*'
Failed to execute operation: No such file or directory

Per risolvere il problema, esegui lo script tableau-server-obliterate per pulire gli eventuali residui del tentativo di installazione precedente e riavvia il computer. Per maggiori informazioni, consulta Eseguire lo script tableau-server-obliterate.

Importante: se hai creato un backup di Tableau (<file>.tsbak) che desideri conservare (ad esempio, per ripristinarlo nella tua nuova installazione), copia tale file in una posizione sicura su un altro computer per garantire che non venga rimosso quando effettui la pulizia sul computer dove esegui Tableau.

L’installazione non riesce a causa di requisiti hardware

Tableau Server non può essere installato se il computer su cui si sta eseguendo l’installazione non soddisfa i requisiti hardware minimi. I requisiti si applicano a tutti i computer in cui si installa Tableau Server. Per informazioni dettagliate sui requisiti hardware minimi, consulta Requisiti hardware minimi e raccomandazioni per Tableau Server.

L’installazione o l’upgrade non riesce a causa di requisiti della CPU

A partire dalla versione 2020.4.0, Tableau Server richiede CPU che supportano i set di istruzioni SSE4.2 e POPCNT. Non è possibile installare o eseguire l’upgrade di Tableau Server 2020.4.0 o versione successiva in computer con CPU che non supportano questi set di istruzioni.

Questo messaggio di errore può essere visualizzato durante una nuova installazione o nel corso della preparazione dell’upgrade di un’installazione esistente: 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

I set di istruzioni SSE4.2 e POPCNT sono comuni da oltre 10 anni e la maggior parte delle CPU più recenti li supporta. Se tuttavia viene visualizzato un errore relativo ai requisiti minimi del processore quando si tenta di installare o eseguire l’upgrade di Tableau Server in una macchina virtuale (VM), potrebbe essere abilitata la modalità di compatibilità del processore nella macchina virtuale. Per installare o eseguire l’upgrade di Tableau in una macchina virtuale correttamente, verifica che la modalità di compatibilità del processore sia disattivata.

Percorso dei registri di aggiornamento

Le mappe non vengono visualizzate o sono visualizzate in modo incompleto dopo l’upgrade

A partire da Tableau versione 2019.2, i requisiti di accesso a Internet sono cambiati per le mappe. Se esegui l’upgrade dalla versione 2019.1.x o precedenti alla versione 2019.2.x o successive e le mappe non vengono visualizzate come previsto, verifica che l’ambiente sia configurato per consentire l’accesso sulla porta 443 a mapsconfig.tableau.com e api.mapbox.com.

Nella versione 2019.1.x o precedenti era necessario l’accesso a maps.tableausoftware.com.

Per maggiori informazioni sui requisiti di accesso a Internet, consulta Comunicare con Internet.

Errore dello script di upgrade: "La convalida del cambio di versione di Tableau Server non è riuscita"

Durante l’upgrade, se esegui lo script upgrade-tsm dalla directory scripts.<version_code> per la versione meno recente, l’upgrade avrà esito negativo e verrà visualizzato il seguente errore:

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

Se viene visualizzato questo errore, passa alla directory scripts.<version_code> per la versione appena installata ed esegui lo script da tale posizione.

Aggiornamento multi-nodo, l’inizializzazione del nodo aggiuntivo ha esito negativo con l’errore "Immettere nuovamente le credenziali"

Se si tenta di inizializzare un nodo aggiuntivo durante l’aggiornamento di Tableau Server e viene visualizzato questo errore:

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

si tratta di un’indicazione che il nodo non può connettersi o comunicare con il nodo iniziale. Questo problema può verificarsi per più motivi:

• Le credenziali immesse non sono valide o sono state digitate in maniera errata. Le credenziali devono essere per un utente che dispone di autorizzazioni amministrative nel computer in cui è stato installato Tableau Server. Non è necessario utilizzare le credenziali dell’utente che ha creato il file bootstrap ma ciò assicura ti stare usando credenziali valide.

• Il firewall locale del computer che si sta tentando di aggiungere non consente la comunicazione con il nodo iniziale. Per maggiori informazioni, consulta Configurazione del firewall locale.

Aggiornamento non riuscito a causa di mancanza di spazio su disco

Se non è disponibile spazio su disco sufficiente per l’esecuzione del programma di installazione di Tableau Server, l’installazione avrà esito negativo. La quantità di spazio su disco necessaria dipende dalle dimensioni del database del repository e dal numero e dalle dimensioni delle estrazioni.

Per liberare spazio sul disco:

1. Crea uno snapshot dell’archivio di log usando il comando tsm maintenance ziplogs.

   Dopo aver creato il file ziplogs, salvalo in un percorso sicuro che non faccia parte dell’installazione di Tableau Server.

2. Elimina i file non necessari usando il comando tsm maintenance cleanup. Per maggiori informazioni, consulta Rimuovere file non necessari.

Upgrade non riuscito durante il processo RebuildSearchIndex

A partire dalla versione 2020.1.x, il passaggio finale di un upgrade consiste nella ricostruzione dell’indice di ricerca. A questo punto è stato eseguito l’upgrade di tutti i servizi, quindi se questo processo ha esito negativo, puoi reimpostare manualmente il server di ricerca eseguendo il comando tsm maintenance reset-searchserver. Non è necessario annullare e ricominciare da capo.

L’errore sarà:

An error occurred while rebuilding search index.

Per reimpostare il server di ricerca:

1. Sul nodo iniziale, apri una sessione di terminale.

   Deve essere una nuova sessione del terminale perché lo script di upgrade aggiorna l’ambiente di sistema per la nuova versione.

2. Ricostruisci l’indice di ricerca utilizzando il comando tsm maintenance reset-searchserver.

Upgrade non riuscito nella versione 2022.1 e successive

Dopo aver aggiornato Tableau Server 2022.1 (o versioni successive), il ripristino di un backup di Tableau Server come parte del processo di upgrade può causare il seguente errore:

"Il backup non può essere ripristinato perché Tableau Server utilizza le nuove tabelle del servizio di identità per impostazione predefinita."

Questo problema si verifica perché Tableau Server 2022.1 (e versioni successive) utilizza uno schema di identità diverso dallo schema di identità utilizzato dal backup. Per risolvere questo problema, consulta Risolvere i problemi relativi alla migrazione delle identità.

Upgrade non riuscito nella versione 2020.4.0 o successiva

A partire dalla versione 2020.4.0, la funzionalità di upgrade con punti di controllo consente di riprovare a eseguire un upgrade non riuscito. In generale, questo è particolarmente utile per gli amministratori di server e i professionisti IT esperti che hanno familiarità con i file di log di Tableau Server e sono disposti a eseguire ricerche al loro interno. Tuttavia, la funzionalità può essere utile in tutti gli upgrade non riusciti perché consente di eseguire nuovamente lo script upgrade-tsm e lo script viene eseguito dall’ultimo passaggio completato, consentendo di risparmiare tempo. Per gli utenti esperti, potrebbe essere possibile identificare problemi come quelli di spazio su disco o relativi alle autorizzazioni, risolverli ed eseguire nuovamente l’upgrade.

Se stai eseguendo l’upgrade alla versione 2020.4.0 o successiva e l’upgrade non riesce, i passaggi seguenti possono consentirti di completare l’upgrade:

• Esegui nuovamente lo script upgrade-tsm. Gli errori di upgrade talvolta sono il risultato di timeout durante il processo di upgrade e la riesecuzione dello script può consentire all’upgrade di superare i problemi intermittenti o occasionali. È anche un’operazione semplice e sicura da eseguire. La riesecuzione dello script non causerà alcun problema: nella peggiore delle ipotesi, l’upgrade avrà esito negativo nello stesso punto, ma senza dover eseguire i passaggi precedenti.

  Lo script è disponibile nella directory \scripts:

  opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm

  Se l’upgrade di Tableau Server non riesce quando esegui nuovamente lo script upgrade-tsm e hai familiarità con i log di Tableau Server, puoi eseguire queste procedure aggiuntive di risoluzione dei problemi:

• Esamina l’output dello script nella finestra di comando.. Messaggi di errore utili possono aiutarti a identificare la causa dell’errore di upgrade e fornirti alcune indicazioni su come correggere il problema.

• Esamina il file app-upgrade.log. Eventuali errori visualizzati nella riga di comando appariranno anche nel file app-upgrade.log, spesso con maggiori dettagli.

• Esamina il file tabadmincontroller.log. I problemi di upgrade che non sono facilmente identificabili nei due casi precedenti sono probabilmente il risultato di un problema in un processo. Il file tabadmincontroller.log potrebbe contenere ulteriori informazioni che consentono di diagnosticare il problema.

  Nota: per informazioni sui percorsi dei file di log, consulta Log di Tableau Server e percorsi dei file di log.

L’upgrade non riesce a causa di problemi di autorizzazione con il percorso del file di backup/ripristino

Con le versioni di Tableau Server precedenti alla 2022.1.0, se il percorso del file di backup/ripristino non dispone delle autorizzazioni corrette, lo script di upgrade avrà esito negativo con un errore relativo all’impossibilità di leggere il file di backup o eseguire il ripristino del repository.

A partire dalla versione 2022.1, lo script di upgrade conferma le autorizzazioni del percorso del file per il file di backup/ripristino prima di avviare l’upgrade, in modo che il file possa essere scritto e letto dal percorso durante l’upgrade alla nuova versione di Tableau Server.

Gli errori saranno simili a questi:

The tableau user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

La posizione utilizzata da TSM per il backup e il ripristino è definita dalla chiave di configurazione basefilepath.backuprestore e ha un’impostazione predefinita che il programma di installazione imposta con le autorizzazioni corrette. Tuttavia, queste potrebbero essere influenzate dalle regole IT dell’organizzazione o se si cambia la posizione in una che hai creato tu stesso. Un nuovo comando disponibile a partire dalla versione 2022.1 consente di controllare le autorizzazioni per il percorso del file di backup/ripristino subito dopo averlo creato, per evitare problemi relativi alle autorizzazioni. Per i dettagli sul comando, consulta tsm maintenance validate-backup-basefilepath.

Per informazioni dettagliate sul percorso del file di backup/ripristino, consulta Percorsi dei file di tsm.

L'aggiornamento riesce ma non è possibile accedere alle origini dati pubblicate

In scenari limitati e specifici, dopo l'aggiornamento di Tableau Server dalla versione 2021.3 alle versioni iniziali 2023.1 o 2023.3, i tentativi di connessione e aggiornamento delle origini dati pubblicate esistenti hanno esito negativo e restituiscono il seguente errore:

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

Ciò può accadere se:

1. Aggiorni in qualsiasi momento un'installazione di Tableau Server con versione 2021.3.x (ad esempio la versione 2021.3 oppure puoi aver effettuato l'aggiornamento dalla versione 2021.3 a una versione 2022.x)
   
   e

2. Aggiorni quell'installazione alle versioni iniziali 2023.1 o 2023.3

Nessun impatto

Non si verificano problemi nelle seguenti situazioni:

• In tutti gli altri percorsi di aggiornamento dalla versione 2021.3

• In tutti gli altri percorsi di aggiornamento alla versione 2023.1 o 2023.3

• In tutte le nuove installazioni delle versioni 2023.1 e 2023.3

Ulteriori informazioni

A partire dal 16 settembre 2024, tutte le versioni problematiche sono state rimosse dal sito dei download. Se è necessario eseguire l'upgrade alla versione 2023.1.x o 2023.3.x, esegui l'aggiornamento alle versioni di manutenzione 2023.1.16 o successive oppure alla versione 2023.3.9 o successive.

Per maggiori informazioni su questo problema, consulta Problemi noti(Il collegamento viene aperto in una nuova finestra).

Problemi comuni di importazione delle impostazioni

>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

Confermare l’accesso al server licenze

Il 6 ottobre 2018 il servizio di gestione licenze di Tableau è stato spostato in un nuovo data center. Ciò significa che tutti gli ambienti che richiedono una configurazione speciale (ad esempio l’inserimento in un elenco di indirizzi attendibili degli IP statici) per accedere a licensing.tableau.com o licensing.tableau.com devono essere aggiornati prima di poter attivare, aggiornare o disattivare un codice prodotto Tableau.

Per verificare l’accesso, digita l’URL e la porta del server licenze in un browser:

https://licensing.tableau.com:443

e:

https://atr.licensing.tableau.com/_status/healthz

Se sei in grado di accedere al server, vengono visualizzati un messaggio "Test riuscito" per il primo server e un messaggio "OK" per il secondo.

Per ottenere la licenza, Tableau Server deve stabilire una connessione alle seguenti posizioni Internet:

• atr.licensing.tableau.com:443

• licensing.tableau.tableau.com:443

• register.tableau.com:443

• o.ss2.us

• s.ss2.us

• crt.rootca1.amazontrust.com

• crt.sca1b.amazontrust.com

• crt.sca0a.amazontrust.com

• crt.sca1a.amazontrust.com

• crt.sca2a.amazontrust.com

• crt.sca3a.amazontrust.com

• crt.sca4a.amazontrust.com

• *.digicert.com

• ocsp.*.amazontrust.com

• crl.*.amazontrust.com

• crt.rootg2.amazontrust.com

Le richieste per i domini di cui sopra possono essere nella porta 80 o 443. La porta 80 viene utilizzata per la convalida del certificato (revoca, catena di certificati e così via). La porta 443 viene utilizzata per le connessioni SSL.

Le richieste ai domini ocsp.*.amazontrust.com e crl.*.amazontrust.com sono gestite da Amazon per le informazioni sulla revoca del certificato. Per maggiori informazioni, consulta Caratteristiche dei certificati ACM(Il collegamento viene aperto in una nuova finestra). Si consiglia di installare i certificati radice di Amazon nell'archivio di attendibilità dei certificati sul computer in cui Tableau è in esecuzione. Per scaricare e installare i certificati radice di Amazon, consulta la pagina relativa alle autorità di certificazione(Il collegamento viene aperto in una nuova finestra) sul sito Web Amazon Trust Services.

Verificare la data e l’ora

Verificare che la data e l’ora nel computer Tableau Server iniziale siano corrette. Se l’orologio è impostato su una data e un’ora precedenti alla data corrente, Tableau Server non può essere attivato.

Forzare la rilettura del codice prodotto

1. Nel computer Tableau Server iniziale accedi come utente con accesso sudo.

2. Passa alla directory di collocazione di Tableau Server. Per impostazione predefinita, è:

   /opt/tableau/tableau_server/packages/bin.<version_code>/

3. Digita i seguenti comandi:

   tsm stop
   
   ./lmreread
   tsm start

Inviare il contenuto di archiviazione attendibile all’Assistenza Tableau

Se il servizio di gestione licenze FlexNet è installato ed è in esecuzione, ma si verifica comunque un errore, potrebbe esserci un problema con le informazioni relative al codice prodotto di Tableau. Per risolvere questo problema, completare i seguenti passaggi per creare un file delle informazioni sulla chiave nell’archiviazione attendibile.

1. Nel computer Tableau Server iniziale accedi come utente con accesso sudo.

2. Digita il seguente comando:

   serveractutil -view > <machine_name>-LicResults.txt

   Nella directory corrente verrà creato il file <machine_name>-LicResults.txt . Se non disponi delle autorizzazioni di scrittura per tale percorso e viene visualizzato un errore, passa a un percorso in cui disponi dell’autorizzazione per creare un file ed eseguire nuovamente il comando.

3. Contatta l’Assistenza Tableau (http://www.tableau.com/it-it/support/request(Il collegamento viene aperto in una nuova finestra)) e includi il file <machine_name>-LicResults.txt creato.

Installare tabcmd separatamente

Tabcmd viene installato automaticamente nel nodo iniziale di Tableau Server durante l’installazione di Tableau Server, ma se desideri eseguirlo in un altro computer, devi scaricare e installare tabcmd separatamente. Per informazioni dettagliate, consulta Installare tabcmd.

Problemi di installazione di tabcmd su Linux

tabcmd richiede Java 11 per funzionare correttamente. Nei sistemi di tipo RHEL verrà installato come dipendenza durante l’installazione di tabcmd. Nei sistemi di tipo Debian, devi installare Java 11 separatamente se non è già installato.

A partire da luglio 2022, le distribuzioni Debian non sono più supportate. Per maggiori informazioni, consulta questo post della Community Tableau(Il collegamento viene aperto in una nuova finestra).

Java non è installato

Se rilevi errori simili a questo durante l’installazione di tabcmd, verifica che Java 11 sia installato nel computer Linux:

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

È installata una versione errata di Java

Se rilevi errori simili a questi, verifica che Java 11 sia installato:

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

o

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.