Guida di Tableau Server su Windows

Per installare il server RMT:

1. Esegui il programma di installazione del server RMT:

   1. Scarica il programma di installazione del server RMT e salvalo in un percorso accessibile dal computer in cui prevedi di installare il server RMT.

   2. Apri il prompt dei comandi come amministratore.

   3. Passa al percorso del programma di installazione del server RMT ed esegui il file exe utilizzando il seguente comando

      Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1

      Nota: utilizza l’opzione /silent o /quiet per eseguire l’installazione automaticamente, senza visualizzare alcuna interfaccia utente o richiesta.

      La cartella di installazione predefinita in genere è: C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master. Per specificare un percorso di installazione diverso, esegui questo comando:

      Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1 InstallFolder="D:\Tableau Resource Monitoring Tool\master"

      L’elenco completo di tutte le proprietà e gli switch del comando di installazione è disponibile di seguito in questa sezione.

   Verranno installati il pacchetto e i prerequisiti, inclusi RabbitMQ, Erlang e un database PostgreSQL. Il database PostgreSQL viene utilizzato per archiviare i dati di utilizzo raccolti da Tableau Server. Il programma procederà quindi all’installazione del server RMT.

2. Configurazione del server RMT:

   1. Esegui questo comando e specifica le opzioni:

      rmtadmin master-setup [options]

      Le opzioni di configurazione possono essere specificate tramite il prompt dei comandi o in un file di configurazione. Se non si specificano le opzioni, verranno applicati i valori predefiniti, ad eccezione della password di amministratore. Il nome utente dell’amministratore verrà impostato su admin e ti verrà richiesto di specificare la password.

      Comando di esempio che include il parametro password richiesto:

      rmtadmin master-setup --admin-username=<name the administrator user> --admin-password=<administrator user password>

      Nella tabella seguente sono elencate le opzioni necessarie e alcune utilizzate comunemente per configurare il server RMT. Per un elenco completo delle opzioni di configurazione, consulta Utilità della riga di comando rmtadmin.

      Nota: l’opzione Richiedi HTTPS garantisce comunicazioni sicure tra il server RMT e gli utenti. Quando richiedi HTTPS per le comunicazioni, devi anche selezionare una modalità per il certificato che deve essere utilizzata per queste comunicazioni. La tabella seguente include le varie opzioni. Per maggiori informazioni su queste modalità e i certificati, consulta Modalità e requisiti per i certificati SSL.

      Opzione	Obbligatorio?	Default	Descrizione
      admin-password	Sì È possibile specificare la password nella riga di comando o specificare un file con la password da utilizzare. Se non viene specificato alcun elemento, ti verrà chiesto di inserire la password.	n/d	Password per l’utente amministratore.
      admin-password-file	No È possibile specificare la password nella riga di comando o specificare un file con la password da utilizzare. Se non viene specificato alcun elemento, ti verrà chiesto di inserire la password.	n/d	File in cui è archiviata la password per l’utente amministratore.
      admin-username	No	admin	Nome utente per l’utente amministratore.
      http-port	No	80
      require-https	No	False	Se True, http non è disponibile. Se False, http verrà inoltrato a https.
      https-certificate-mode	No	"Default" Opzioni disponibili: Default Store Local	Tipo di ricerca del certificato da eseguire per il certificato HTTPS. Default: questa modalità utilizza il certificato autofirmato predefinito fornito dal programma di installazione. Store: consente di immettere l’identificazione personale di un certificato nell’archivio certificati di Windows. Local: consente di specificare un certificato basato su file nella cartella config.
      https-certificate-store-thumbprint	No	NULL	Hash/identificazione personale del certificato HTTPS da cercare nella modalità certificato "store".
      https-certificate-local-name	No	NULL Nota: se non è specificato, Resource Monitoring Tool viene installato con un certificato autofirmato e utilizzerà tale certificato per le comunicazioni HTTPS.	Nome del file del certificato HTTPS senza l’estensione del file.
      https-certificate-local-password	No	NULL	Password da utilizzare per il certificato HTTPS.
      https-certificate-local-password-file	No	NULL	Percorso del file contenente la password da utilizzare per il certificato HTTPS.

3. Crea un ambiente:

   1. Esegui questo comando per creare un ambiente:

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      Configura l’ambiente utilizzando le opzioni disponibili per questo comando. Ecco alcune opzioni di configurazione principali da valutare:

      • L’API REST di Tableau Server e le configurazioni del repository di Tableau Server vengono utilizzate per comunicare con Tableau Server. La configurazione del repository di Tableau Server è facoltativa, ma rappresenta un metodo preferenziale per l’accesso a Tableau Server.

      • Puoi configurare la connessione crittografata protetta quando RMT si connette al repository di Tableau Server. Per utilizzare connessioni SSL tra RMT e il database del repository di Tableau Server, Tableau Server deve essere configurato per l’utilizzo di SSL. Per maggiori informazioni, consulta Configurare SSL per le comunicazioni interne a Postgres.

      Nella tabella seguente sono elencate alcune opzioni comuni. Per un elenco completo delle opzioni, consulta Utilità della riga di comando rmtadmin.

      Opzione	Obbligatorio?	Default	Descrizione
      --name	Sì	n/d	Nome dell’ambiente.
      --gateway-url	Sì	n/d	URL utilizzato per accedere al gateway di Tableau Server.
      --version	Sì	n/d	Versione di Tableau Server che verrà monitorata da questo ambiente.
      --api-username	No	NULL	Nome utente dell’account utilizzato per connettersi alle API di Tableau Server. L’account utente deve essere un amministratore di Tableau Server con accesso a tutti i siti di Tableau Server.
      --api-password	No Se specifichi il nome utente dell’API di Tableau, fornisci la password o specifica il percorso e il file con la password	NULL	Password dell’account utente dell’API di Tableau Server utilizzato per la connessione alle API di Tableau Server.
      --api-password-file	No	NULL	Percorso e nome del file contenente la password dell’account utente dell’API di Tableau Server.
      --repository-server	Sì	NULL	È il nome del server per il database PostgreSQL installato con Tableau Server
      --repository-port	Sì	NULL	Numero di porta del repository di Tableau Server.
      --repository-username	Sì	NULL	Nome utente utilizzato per la connessione al database PostgreSQL installato con il repository di Tableau Server. Resource Monitoring Tool accede direttamente al database del repository di Tableau Server per motivi di prestazioni. Per il corretto funzionamento di questa funzionalità, è necessario abilitare l’accesso al repository impostando una password per l’utente del database readonly. Per i dettagli, vedi Consentire l’accesso al repository di Tableau Server.
      --repository-password	Sì	NULL	Password per l’account utente utilizzato per la connessione al database PostgreSQL installato con Tableau Server. Resource Monitoring Tool accede direttamente al database del repository di Tableau Server per motivi di prestazioni. Per il corretto funzionamento di questa funzionalità, è necessario abilitare l’accesso al repository impostando una password per l’utente del database readonly. Per i dettagli, vedi Consentire l’accesso al repository di Tableau Server.
      --repository-password-file	No	NULL	Percorso, incluso il nome del file, della password dell’account utente utilizzato per la connessione al database PostgreSQL installato con Tableau Server.
      --repository-ssl-mode	No	Prefer	Modalità SSL del repository di Tableau Server: Prefer SSL o Require SSL per configurare le connessioni SSL al repository di Tableau. Disable per non utilizzare mai SSL per effettuare connessioni al repository di Tableau Server.
      --repository-ssl-thumbprint	No	NULL	Puoi scegliere di fornire l’identificazione personale generata da Tableau Server oppure copiare il file server.crt nel computer del server Resource Monitoring Tool (server RMT). Se scegli di copiare il file del certificato, non è necessario fornire l’identificazione personale. Per ulteriori informazioni, consulta Configurare SSL Postgres per consentire le connessioni dirette da client.

   2. Scarica il file di bootstrap in un percorso accessibile dai nodi di Tableau Server.

      rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>

Proprietà e switch di installazione per Windows

Switch:

Proprietà:

Per installare il server RMT:

1. Installa il server RMT:

   1. Scarica il programma di installazione rpm o deb del server RMT e salvalo in un percorso accessibile dal computer in cui prevedi di installare il server RMT.

   2. Accedi al computer in cui desideri installare il server RMT come utente con accesso sudo.

   3. Esegui il comando seguente per installare il server RMT, dove <version> è nel formato principale-secondaria-manutenzione:

      Per una distribuzione di tipo RHEL, tra cui CentOS:

      sudo yum install <path/to/rmtserverinstaller>/Tabrmt-Master-x86_64-<version>.rpm

      Per le distribuzioni Ubuntu:

      sudo apt install ./ <path/to/rmtserverinstaller>/Tabrmt-Master-amd64-<version>.deb

   Verranno installati il pacchetto e i prerequisiti, inclusi RabbitMQ, Erlang e un database PostgreSQL. Il database PostgreSQL viene utilizzato per archiviare i dati di utilizzo raccolti da Tableau Server. Il programma procederà quindi all’installazione del server RMT.

2. Inizializzare il server RMT:

   Quando inizializzi il server RMT, devi accettare esplicitamente il Contratto di licenza con l’utente finale (EULA). Hai anche la possibilità di specificare configurazioni non predefinite. Per inizializzare il server RMT con una configurazione predefinita, esegui questo comando:

   sudo /opt/tableau/tabrmt/master/install-scripts/initialize-rmt-master --accepteula

   Il Contratto di licenza con l’utente finale è disponibile nella cartella /opt/tableau/tabrmt/master/docs.

   A partire dalla versione 2023.1 è possibile specificare un account RunAs personalizzato che verrà usato da RMT, nonché altre opzioni di configurazione. Per impostazione predefinita, RMT crea e utilizza un account denominato rmt-master per l’esecuzione. Per specificare un account RunAs personalizzato utilizzabile dal server RMT, includi l’opzione --unprivileged-user quando esegui lo script di inizializzazione. Per informazioni su tutte le opzioni disponibili per lo script initialize-rmt-master, consulta Opzioni dello script di inizializzazione del server RMT.

3. Configurazione del server RMT:

   1. Esegui questo comando come utente tabrmt-master:

      sudo su --login tabrmt-master

      rmtadmin master-setup [options]

      Le opzioni di configurazione possono essere specificate tramite il prompt dei comandi o un file di configurazione. Se non si specificano le opzioni, verranno applicati i valori predefiniti, ad eccezione della password dell’amministratore. Il nome utente dell’amministratore verrà impostato su admin e ti verrà richiesto di specificare la password.

      Comando di esempio che include il parametro password richiesto:

      rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>

      Nella tabella seguente sono elencate le opzioni necessarie e alcune utilizzate comunemente per configurare il server RMT. Per un elenco completo delle opzioni di configurazione, consulta Utilità della riga di comando rmtadmin.

      Nota: l’opzione Richiedi HTTPS garantisce comunicazioni sicure tra il server RMT e gli utenti. Quando richiedi HTTPS per le comunicazioni, devi anche selezionare una modalità per il certificato che deve essere utilizzata per queste comunicazioni. La tabella seguente include le varie opzioni. Per maggiori informazioni su queste modalità e i certificati, consulta Installare lo Tableau Resource Monitoring Tool.

      Opzione	Obbligatorio?	Default	Descrizione
      admin-password	Sì È possibile specificare la password nella riga di comando o specificare un file con la password da utilizzare. Se non viene specificato alcun elemento, ti verrà chiesto di inserire la password.	n/d	Password per l’utente amministratore.
      admin-password-file	No È possibile specificare la password nella riga di comando o specificare un file con la password da utilizzare. Se non viene specificato alcun elemento, ti verrà chiesto di inserire la password.	n/d	File in cui è archiviata la password per l’utente amministratore. Nota: l’utente tabrmt-master deve avere accesso a questo file.
      admin-username	No	admin	Nome utente per l’utente amministratore.
      http-port	No	80
      require-https	No	False	Reindirizza il traffico http a HTTPS.
      https-certificate-mode	No	Opzioni disponibili: Default Local	Tipo di ricerca del certificato da eseguire per il certificato HTTPS. Default: questa modalità utilizza il certificato autofirmato predefinito fornito dal programma di installazione. Local: consente di specificare un certificato basato su file nella cartella <directory di installazione>\config. Per impostazione predefinita, il percorso è C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.
      https-certificate-local-name	No Nota: se non è specificato, Resource Monitoring Tool viene installato con un certificato autofirmato e utilizzerà tale certificato per le comunicazioni HTTPS.	NULL	Nome del file del certificato HTTPS senza l’estensione del file.
      https-certificate-local-password	No	NULL	Password da utilizzare per il certificato HTTPS.
      https-certificate-local-password-file	No	NULL	Percorso del file contenente la password da utilizzare per il certificato HTTPS.

4. Crea un ambiente:

   1. Esegui questo comando per creare un ambiente:

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      Configura l’ambiente utilizzando le opzioni disponibili per questo comando. Ecco alcune opzioni di configurazione principali da valutare:

      • L’API REST di Tableau Server e le configurazioni del repository di Tableau Server vengono utilizzate per comunicare con Tableau Server. La configurazione del repository di Tableau Server è facoltativa, ma rappresenta un metodo preferenziale per l’accesso a Tableau Server.

      • Puoi configurare la connessione crittografata protetta quando RMT si connette al repository di Tableau Server. Per utilizzare connessioni SSL tra RMT e il database del repository di Tableau Server, Tableau Server deve essere configurato per l’utilizzo di SSL. Per maggiori informazioni, consulta Configurare SSL per le comunicazioni interne a Postgres.

      Nella tabella seguente sono elencate alcune opzioni comuni. Per un elenco completo delle opzioni, consulta Utilità della riga di comando rmtadmin.

      Opzione	Obbligatorio?	Default	Descrizione
      --name	Sì	n/d	Nome dell’ambiente.
      --gateway-url	Sì	n/d	URL utilizzato per accedere al gateway di Tableau Server.
      --version	Sì	n/d	Versione di Tableau Server che verrà monitorata da questo ambiente.
      --api-username	No	NULL	Nome utente dell’account utilizzato per connettersi alle API di Tableau Server. L’account utente deve essere un amministratore di Tableau Server con accesso a tutti i siti di Tableau Server.
      --api-password	No Se specifichi il nome utente dell’API di Tableau, fornisci la password o specifica il percorso e il file con la password	NULL	Password dell’account utente dell’API di Tableau Server utilizzato per la connessione alle API di Tableau Server.
      --api-password-file	No	NULL	Percorso e nome del file contenente la password dell’account utente dell’API di Tableau Server.
      --repository-server	Sì	NULL	È il nome del server per il database PostgreSQL installato con Tableau Server
      --repository-port	Sì	NULL	Numero di porta del repository di Tableau Server.
      --repository-username	Sì	NULL	Nome utente utilizzato per la connessione al database PostgreSQL installato con il repository di Tableau Server. Resource Monitoring Tool accede direttamente al database del repository di Tableau Server per motivi di prestazioni. Per il corretto funzionamento di questa funzionalità, è necessario abilitare l’accesso al repository impostando una password per l’utente del database readonly. Per i dettagli, vedi Consentire l’accesso al repository di Tableau Server.
      --repository-password	Sì	NULL	Password per l’account utente utilizzato per la connessione al database PostgreSQL installato con Tableau Server. Resource Monitoring Tool accede direttamente al database del repository di Tableau Server per motivi di prestazioni. Per il corretto funzionamento di questa funzionalità, è necessario abilitare l’accesso al repository impostando una password per l’utente del database readonly. Per i dettagli, vedi Consentire l’accesso al repository di Tableau Server.
      --repository-password-file	No	NULL	Percorso, incluso il nome del file, della password dell’account utente utilizzato per la connessione al database PostgreSQL installato con Tableau Server.
      --repository-ssl-mode	No	Prefer	Modalità SSL del repository di Tableau Server: Prefer SSL o Require SSL per configurare le connessioni SSL al repository di Tableau. Disable per non utilizzare mai SSL per effettuare connessioni al repository di Tableau Server.
      --repository-ssl-thumbprint	No	NULL	Puoi scegliere di fornire l’identificazione personale generata da Tableau Server oppure copiare il file server.crt nel computer del server Resource Monitoring Tool (server RMT). Se scegli di copiare il file del certificato, non è necessario fornire l’identificazione personale. Per ulteriori informazioni, consulta Configurare SSL Postgres per consentire le connessioni dirette da client.

   2. Scarica il file di bootstrap in un percorso accessibile dai nodi di Tableau Server.

      rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>

5. Passaggio facoltativo - solo se non si utilizza SSD: Resource Monitoring Tool è ottimizzato per SSD per impostazione predefinita. Se non utilizzi hardware SSD, esegui il comando:

   sudo /opt/tableau/tabrmt/master/tabrmt-master optimize --no-ssd