Installare il server RMT tramite la riga di comando
Il server Resource Monitoring Tool (server RMT) ospita l’applicazione Web con cui interagiscono gli utenti. Svolge anche gran parte dell’elaborazione in background per raccogliere e monitorare i dati provenienti dagli agenti. Il server RMT deve essere installato su un hardware dedicato.
In questo argomento viene descritta la procedura che è possibile utilizzare per installare il server RMT tramite la riga di comando. L’installazione dalla riga di comando è supportata sia nei sistemi operativi Windows che Linux.
Nel tentativo di allinearci con i nostri valori aziendali di uguaglianza, abbiamo modificato la terminologia non inclusiva, quando possibile. Poiché la modifica dei termini in determinati punti può causare problemi per il funzionamento del prodotto, verrà mantenuta la terminologia esistente. Potrai quindi continuare a vedere i termini nei comandi e nelle opzioni dell’interfaccia a riga di comando, nelle cartelle di installazione, nei file di configurazione e in altri casi. Per maggiori informazioni, consulta Informazioni sulla Guida di Tableau(Il collegamento viene aperto in una nuova finestra).
Per installare il server RMT:
- Esegui il programma di installazione del server RMT:
Scarica il programma di installazione del server RMT e salvalo in un percorso accessibile dal computer in cui prevedi di installare il server RMT.
Apri il prompt dei comandi come amministratore.
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=1Nota: 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.
- Configurazione del server RMT:
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.
SeFalse, 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.
Crea un ambiente:
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. 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:
| Switch | Descrizione | Commenti |
|---|---|---|
/install | /uninstall | Esegui il programma di installazione per installare o disinstallare Resource Monitoring Tool. | L’impostazione predefinita prevede l’installazione, la visualizzazione dell’interfaccia utente e tutti i prompt. Se non viene specificata alcuna directory utilizzando la proprietà InstallFolder durante una nuova installazione, verrà utilizzato il percorso C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master. Se Resource Monitoring Tool è già installato, il programma di installazione utilizzerà lo stesso percorso dell’installazione corrente. Per rimuovere completamente Resource Monitoring Tool inclusa la directory dei dati, utilizza |
/passive | Esegui il programma di installazione con l’interfaccia utente minima e nessun prompt. | |
/quiet | /silent | Esegui l’installazione in modalità completamente silenziosa e automatica. Non viene visualizzata alcuna interfaccia Web o richiesta. | Utilizza /quiet o /silent, non entrambi. |
/norestart | Esegui il programma di installazione senza riavviare Windows, anche se è necessario un riavvio. | In alcuni rari casi, non è possibile evitare il riavvio, anche quando si utilizza questa opzione. Questo in genere avviene quando è stato saltato un riavvio del sistema precedente. Ad esempio, se è stato saltato il riavvio durante l’installazione di un altro software. |
/log <log-file> | Registra le informazioni nel percorso e nel file specificato. Per impostazione predefinita, i file di log vengono creati in %TEMP% con una convenzione di denominazione simile a Tableau_Resource_Monitoring_Tool_<codice_versione>. | Se non viene specificata alcuna posizione del file, il file di log viene scritto nella cartella TEMP dell’utente: C:\Users\<nomeutente>\AppData\Local\Temp. Controlla che questo file di log non presenti errori dopo l’installazione. Ad esempio: |
Proprietà:
| Proprietà | Descrizione | Commenti |
|---|---|---|
InstallFolder=<path\to\installation\directory> | Procedi all’installazione nella posizione di installazione non predefinita specificata. | Specifica il percorso di installazione di RMT. Se non viene utilizzato, RMT è installato in C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master. Esempio: |
ACCEPTEULA=1|0 | Accetta il Contratto di licenza con l’utente finale (EULA). È necessario per l’installazione in modalità quiet, silent e passive su nodi iniziali e aggiuntivi. 1 = true, dai il consenso per l’EULA, 0 = false, nega il consenso per l’EULA. | Se non viene incluso quando si usa /passive, /silent o /quiet, l’installazione non va a buon fine in modo silenzioso. Se incluso ma impostato su 0, il programma di installazione avrà esito negativo. |
Per installare Resource Monitoring Tool, devi disporre di tutti gli elementi seguenti:
Windows
- Autorizzazioni di amministratore sul computer in cui desideri installare Resource Monitoring Tool.
- Ruolo del sito Amministratore di Tableau Server.
- Account di amministratore per Resource Monitoring Tool.
Linux
- Accesso sudo completo per l’account utente utilizzato per installare l’agente.
- Account di amministratore per Resource Monitoring Tool