Guida all’implementazione di Tableau

L’attivazione di Tableau Desktop o Tableau Prep Builder non sempre potrebbe andare come previsto. Questo articolo offre informazioni sui problemi che potrebbero verificarsi e suggerimenti su come risolverli.

I passaggi per la risoluzione dei problemi descritti in questo argomento si applicano solo a Tableau Desktop e Tableau Prep Builder quando sono attivati con un codice prodotto.

Risoluzione dei problemi relativi ad altri scenari di licenza:

• Attivazioni con gestione delle licenze basata sull’accesso (LBLM)

  I passaggi per la risoluzione dei problemi non si applicano alle attivazioni con gestione delle licenze basata sull’accesso (LBLM).

• LBLM in Tableau Cloud

  Per maggiori informazioni sulla gestione delle licenze basata sull’accesso con Tableau Cloud, consulta Informazioni sui modelli di licenza(Il collegamento viene aperto in una nuova finestra) nella Guida di Tableau Cloud. Per la risoluzione dei problemi relativi alla gestione delle licenze basata sull’accesso in Tableau Cloud, consulta Risoluzione dei problemi relativi alla gestione delle licenze basata sull’accesso(Il collegamento viene aperto in una nuova finestra) nella Guida di Tableau Cloud.

• LBLM in Tableau Server

  • Per la risoluzione dei problemi relativi alla gestione delle licenze basata sull’accesso in Tableau Server su Linux, consulta Risoluzione dei problemi relativi alla gestione delle licenze basata sull’accesso(Il collegamento viene aperto in una nuova finestra) nella Guida di Tableau Server per Linux.

  • Per la risoluzione dei problemi relativi alla gestione delle licenze basata sull’accesso in Tableau Server su Windows, consulta Risoluzione dei problemi relativi alla gestione delle licenze basata sull’accesso(Il collegamento viene aperto in una nuova finestra) nella Guida di Tableau Server per Windows.
    

• Gestione delle licenze dei desktop virtuali

  Per la risoluzione dei problemi relativi alle licenze dei desktop virtuali, consulta Risolvere i problemi relativi al desktop virtuale.

Cercare nella Knowledge Base del supporto

Per trovare rapidamente risposta alle tue domande, puoi eseguire una ricerca nella Knowledge Base. La Knowledge Base contiene le tecniche di risoluzione che puoi utilizzare per risolvere i problemi, descrive i problemi noti che sono stati risolti e fornisce le risposte alle domande frequenti.

1. Per cercare articoli sulla risoluzione dei problemi, vai alla Knowledge Base.

2. Cerca tra le risorse principali per prodotto o seleziona Chiedi a Agentforce e digita le tue domande utilizzando il linguaggio naturale.

   

Risolvere gli errori di gestione licenze FlexNet quando si attiva o si apre Tableau Desktop o Tableau Prep Builder

Se il servizio di gestione licenze di Tableau non è in grado di leggere o accedere al codice prodotto, potrebbe verificarsi uno dei seguenti errori:

• Nessuna licenza trovata per “TableauDesktop”.

• Impossibile aggiungere la licenza

• La funzione flxActCommonLicSpcPopulateFromTS ha restituito l’errore 50030, 71521, 0

• FLEXNet Licensing Service non è presente

• La funzione flxActAppActivationSend ha restituito l’errore (0,0,0)

Per risolvere l’errore, esegui i passaggi di questa sezione nell’ordine indicato.

1. Verificare la data e l’ora del sistema

Verifica che la data e l’ora sul computer siano impostate sulla data corrente. Se l’orologio del computer è impostato su una data precedente a quella attuale, Tableau non può essere attivato.

2. Verificare che il servizio di gestione licenze FlexNet sia installato

Quando installi Tableau Desktop, il servizio di gestione licenze FlexNet viene installato automaticamente. Tableau richiede questo servizio per funzionare. Quando installi Tableau Desktop su Mac, potrebbe essere richiesto di inserire la password per dare al programma di installazione il permesso di installare FlexNet. Per Windows, l’autorizzazione ad installare FlexNet è implicita nelle impostazioni dell’account utente.

Per verificare se il servizio di gestione licenze è installato correttamente sul computer, completa la procedura seguente:

Windows

1. Passa alla cartella seguente:

   C:\Program Files\Common Files\Macrovision Shared\FlexNet Publisher

2. Verifica che l’applicazione servizio di gestione licenze FNP si trovi nella cartella.

   Se il servizio di gestione licenze FlexNet non è installato, prova a reinstallare Tableau Desktop o controlla le impostazioni delle autorizzazioni dell’account utente.

Mac

1. Avvia l’applicazione Terminale.

2. Digita il seguente comando per elencare il contenuto della directory FlexNet:

   ls '/Library/Application Support/FLEXnet Publisher/Service/11.16.2/FNPLicensingService'

   Se il comando non restituisce nulla, o se restituisce il messaggio No such file or directory, il servizio di gestione licenze non è installato. Per informazioni su come installare manualmente il servizio di gestione licenze FLEXNet, consulta Errore: “FLEXNet Licensing Service non è presente sul sistema” durante l’attivazione su Mac(Il collegamento viene aperto in una nuova finestra) nella Knowledge Base di Salesforce.

3. Verificare che il servizio di gestione licenze FlexNet sia in funzione

Se hai verificato che il servizio di gestione licenze FlexNet è installato, verifica che tale servizio sia in funzione. Se non lo è, potrebbe essere necessario avviare manualmente il servizio. Per avviare il servizio, completa la procedura seguente in base al sistema operativo, quindi riavvia Tableau Desktop.

Windows

1. Dal menu Start di Windows, apri services.msc.

2. Nella finestra di dialogo Servizi, verifica che lo stato del servizio di gestione licenze FlexNet sia stato avviato.

   Se l’opzione Avvio è disattivata, fai clic con il tasto destro del mouse sul servizio di gestione licenze FlexNet nell’elenco e seleziona Proprietà. Nella scheda Generale, fai clic su Start, quindi fai clic su OK per chiudere la finestra di dialogo.

Mac

1. Avvia l’applicazione Terminale.

2. Passa alla directory FlexNet:

   '/Applications/Tableau Desktop <Tableau version.app>/Contents/Frameworks/FlexNet/'custactutil -view

   Ad esempio: '/Applications/Tableau Desktop 2021.3.app/Contents/Frameworks/FlexNet/'custactutil -view

3. Verifica che il servizio di gestione licenze FlexNet sia in funzione. Dovresti visualizzare Trust Flags = FULLY TRUSTED e Status = ENABLED.

   

4. Quindi utilizza il seguente comando per salvare l’output in un file sul desktop:

   /Applications/Tableau\ Desktop\ <Tableau version.app>/Contents/Frameworks/FlexNet/custactutil -view > /users/$(whoami)/Desktop/licresults.txt

   Se il servizio FlexNet non è in esecuzione, il pacchetto FLEXNet potrebbe non essere installato o risultare illeggibile nel computer su cui è in esecuzione Tableau Desktop, oppure Tableau Desktop è stato installato in un volume non predefinito. Per ricreare la cartella FLEXnet, prova a eseguire queste operazioni:

   1. Chiudi tutte le istanze di Tableau Desktop.

   2. Dal desktop di MacOS X, premi Comando+MAIUSC+G.

   3. Nella finestra di dialogo Vai alla cartella immetti: /Library/Preferences/FLEXnet Publisher/

   4. Rinomina la cartella FLEXnet aggiungendo “_backup”.

   5. Avvia Tableau Desktop e attiva il codice prodotto

      Se la procedura non risolve il problema, prova a reinstallare Tableau Desktop. Se il problema persiste, contatta l’assistenza tecnica(Il collegamento viene aperto in una nuova finestra).

   Se Tableau Desktop è installato su un volume secondario o non predefinito, sposta manualmente FNPLicensingService nella directory della libreria radice attenendoti alla seguente procedura:

   1. Nel Finder, individua il file FNPLicensingService che si trova nella cartella “/Library/Application Support/FLEXnet Publisher/Service/<numero di versione>/” sullo stesso volume in cui è installato Tableau Desktop.

   2. Copia FNPLicensingService nella libreria radice di sistema e crea le cartelle necessarie: /Library/Application Support/FLEXnet Publisher/Service/<numero di versione>

   3. Dopo aver posizionato correttamente tale file, avvia e attiva Tableau Desktop.

4. Riparazione dell’archivio attendibile

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, completa i seguenti passaggi per riparare le informazioni chiave che si trovano e sono salvate in un archivio attendibile.

Nota: per eseguire questi passaggi devi accedere all’Utilità di Attivazione Cliente situata nella cartella del cestino. Se i comandi per Flexera non funzionano, non ti sarà possibile creare un file LicResults.txt.

Windows

1. Apri una finestra di comando e naviga fino alla directory in cui si trova l’Utilità di Attivazione Cliente. Ad esempio:

   cd "C:\Program Files\Tableau\Tableau <version>\bin"

   Dove <version> è la versione del prodotto Tableau installata.

2. Digita il seguente comando:

   custactutil –localrepair

3. Avvia Tableau.

   Se la riparazione non viene eseguita correttamente, digita il seguente comando per creare un file LicResults.txt:

   custactutil -view >LicResults.txt

   Contatta l’Assistenza tecnica(Il collegamento viene aperto in una nuova finestra) e includi il file LicResults.txt creato.

Mac

1. Avvia l’applicazione Terminale.

2. Passa alla directory FlexNet:

   cd /Applications/Tableau Desktop <version>.app>/Contents/Frameworks/Flexnet

3. Immetti il seguente comando:

   ./custactutil -localrepair

4. Avvia Tableau.

Se la riparazione non viene eseguita correttamente, digita il seguente comando per creare un file LicResults.txt:

./custactutil -view > /users/<username>/licresults.txt

Contatta l’Assistenza tecnica(Il collegamento viene aperto in una nuova finestra) e includi il file LicResults.txt creato.

Nota: prima di contattare l’Assistenza tecnica, rimuovi la cartella Flexera e apri di nuovo il desktop per ricreare questa cartella.

Risolvere i problemi relativi agli errori di attivazione utilizzando i codici di uscita dell’attivazione

Quando avvii Tableau e includi l’opzione -activate, il processo di attivazione restituisce informazioni di stato impostando la variabile di ambiente ERRORLEVEL su un codice di uscita. Se l’attivazione ha avuto successo, il codice di uscita dell’applicazione Tableau è 0 (zero). La tabella seguente elenca i codici di uscita dal processo di attivazione e il loro significato.

Se l’attivazione non avviene con successo, puoi trovare informazioni sugli errori anche nel file di log di Tableau. I file di log si trovano nella cartella Logs della cartella My Tableau Repository sotto la cartella Documents dell’utente attuale. Ad esempio:

/Users/<user>/Documents/My Tableau Repository/Logs

Lo script di esempio seguente mostra come attivare Tableau Desktop per Windows e controllare la presenza di errori specifici, come un codice prodotto non valido (536871018) e problemi generali di licenza (536871012).

@echo off
start/wait tableau.exe -activate  <product_key>
if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

Risolvere i problemi di accesso al server delle licenze

Tutti gli ambienti che richiedono una configurazione speciale (ad esempio l’inserimento in un elenco consentiti degli IP statici) per accedere a licensing.tableau.com o atr.licensing.tableau.com devono essere aggiornati prima di poter attivare, aggiornare o disattivare un codice prodotto Tableau.

Per verificare se questo è il problema:

1. In un browser web, passa ai seguenti indirizzi:

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

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

   Dovresti vedere il messaggio “OK” nella pagina.

2. Se non visualizzi tale pagina, potrebbe essere necessario aggiornare l’ambiente locale per accedere ai servizi di licenza. Per ulteriori informazioni, consulta Tableau Community(Il collegamento viene aperto in una nuova finestra).

Per ulteriori dettagli sui requisiti degli indirizzi Internet per Tableau Desktop e Tableau Prep Builder, consulta Indirizzi, proxy e porte richiesti.

Risoluzione dei problemi dei report licenze (solo Tableau Desktop)

Quando le istanze di Tableau Server e Tableau Desktop sono configurate correttamente, le informazioni sull’utilizzo della licenza di Tableau Desktop sono disponibili in due viste amministrative, Utilizzo della licenza desktop(Il collegamento viene aperto in una nuova finestra) e Scadenza della licenza desktop(Il collegamento viene aperto in una nuova finestra). Se non riesci a visualizzare queste viste, o se non ci sono dati all’interno di esse, potrebbe esserci un problema con il report licenze. Le sezioni seguenti possono aiutare a risolvere i problemi relativi a tale causa.

Per informazioni su come configurare i report di Tableau Desktop, consulta Gestire l’utilizzo delle licenze di Tableau Desktop.

Le viste amministrative non sono disponibili

Le viste amministrative di reporting delle licenze desktop sono disponibili solo per gli amministratori di Tableau Server. Se non vedi i collegamenti alle viste Utilizzo della licenza desktop e Scadenza della licenza desktop nella pagina Stato del server (seleziona Gestisci tutti i siti dal menu Siti), verifica quanto segue:

• Hai effettuato l’accesso come amministratore di Tableau Server.

• Il report licenze è abilitato in Tableau Server. (La funzione è disabilitata per impostazione predefinita.) Per ulteriori informazioni, vedi la procedura per abilitare il report licenze su Tableau Server nell’articolo Gestire l’utilizzo delle licenze di Tableau Desktop in questa guida.

Le viste amministrative non includono il contenuto previsto

Se non vengono visualizzati i dati attesi, potrebbe essere per uno dei motivi qui elencati.

Tableau Desktop è stato configurato meno di otto ore fa

Per impostazione predefinita, Tableau Desktop invia il report dei dati di licenza dopo un intervallo di otto ore. I dati di utilizzo potrebbero non essere visualizzati nelle viste amministrative se sono passate meno di otto ore da quando le istanze di Tableau Desktop sono state configurate per il reporting. Tableau Desktop invia i report ogni otto ore durante l’esecuzione, con il conteggio delle ore che inizia quando avvii un’istanza correttamente configurata di Tableau Desktop.

Se Tableau Desktop non è ancora in esecuzione al raggiungimento delle otto ore, viene inviato un report al successivo avvio di Tableau Desktop. Attendi almeno otto ore dopo la configurazione delle istanze di Tableau Desktop prima di cercare le licenze nelle viste di reporting delle licenze desktop.

I seguenti eventi forzano l’esecuzione immediata di un report da un’istanza di Tableau Desktop correttamente configurata a Tableau Server:

• Attivazione di Tableau Desktop

• Disattivazione di Tableau Desktop

• Rinnovo della manutenzione per una licenza per Tableau Desktop

Tableau Desktop non è stato riavviato da quando è stato configurato il report licenze

Se Tableau Desktop era già in esecuzione quando il report licenze è stato configurato con un indirizzo server al quale inviare il report, Tableau Desktop deve essere riavviato.

Tableau Desktop non è stato aperto da quando è stato configurato per il report licenze

Se Tableau Desktop non è stato aperto da quando è stato configurato per il reporting, è possibile che i dati di utilizzo non vengano visualizzati nelle viste amministrative. Il report delle informazioni sulla licenza viene inviato solo quando Tableau Desktop è in esecuzione.

Tableau Desktop non è configurato correttamente per il report licenze

Verifica che le istanze di Tableau Desktop siano configurate correttamente con l’indirizzo di Tableau Server al quale inviare il report.

Utilizza i file di log sul computer Tableau Desktop per determinare se l’istanza è configurata correttamente. Trova il file di log %Documents%\My Tableau Repository\Logs\log.txt. Cerca "licUsageReport" per trovare le voci relative al report licenze.

Messaggi di errore per il report licenze

La seguente tabella elenca i messaggi di log che possono aiutare a identificare i problemi di report licenze.

Modifica dell’intervallo di reporting predefinito

Per impostazione predefinita, quando è configurato per il reporting delle licenze desktop, Tableau Desktop invia i report al server o ai server configurati ogni otto ore. Puoi modificare il registro di sistema o il file .plist sui computer Tableau Desktop per modificare questo intervallo. Ciò è particolarmente utile per la risoluzione dei problemi.

Windows

Per modificare la frequenza con cui Tableau Desktop invia i report al server da un computer Windows, modifica il registro per aggiungere un valore stringa alla chiave ReportingServer:

• Percorso: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ReportingServer

• Nome: aggiungi un valore di stringa denominato scheduleReportInterval.

• Dati: la quantità di tempo, in secondi, tra i report inviati da Tableau Desktop al server. Per impostazione predefinita corrisponde a 8 ore e se non c’è nessuna voce viene utilizzato il valore predefinito. Aumenta questo valore per la risoluzione dei problemi, se necessario, ma tieni presente che più frequente è l’intervallo, più traffico di rete viene generato.

  Ad esempio, l’immagine seguente mostra un registro di sistema configurato in modo che Tableau Desktop invii report a Tableau Server configurati ogni ora (3600 secondi):

  

Mac

Per modificare la frequenza con cui Tableau Desktop invia i report al server per Mac, modifica il file com.tableau.ReportingServer.plist in /Library/Preferences e aggiungi una chiave scheduleReportInterval. Imposta questo valore sulla durata, in secondi, tra i report da Tableau Desktop al Tableau Server configurato. L’esempio seguente mostra il contenuto di un file .plist configurato per inviare informazioni ogni ora (3600 secondi) a due server, https://mytableau02:8010 e http://mytableau.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0">
    <dict>
      <key>Server</key>
      <string>https://mytableau02:8010,http://mytableau</string> 
      <key>scheduleReportInterval</key>
      <string>3600</string>
    </dict>
</plist>