Upgrade di Resource Monitoring Tool

Queste istruzioni sono destinate all’aggiornamento di un’installazione esistente di Tableau Resource Monitoring Tool.

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.

Nota: il Resource Monitoring Tool esegue un aggiornamento sul posto, aggiornando l’installazione corrente alla versione più recente. Non disinstallare l’installazione esistente prima dell’upgrade.

Note sull’upgrade

Tieni presenti i seguenti aspetti prima di avviare il processo di upgrade:

  1. Se intendi passare a utilizzare un repository esterno (PostgreSQL) o un servizio per la coda di messaggi esterna (RabbitMQ), assicurati di leggere la sezione relativa alle procedure consigliate per l’upgrade nei seguenti argomenti:
  2. A partire dalla versione 2022.3, Tableau Resource Monitoring Tool incorpora le comunicazioni crittografate tra server RMT e agenti. Per abilitare TLS, dovrai però eseguire rmtadmin rotate-mq-certificates in tutti gli agenti. Questo vale per RabbitMQ che è configurato in locale nello stesso computer del server RMT. Per ulteriori dettagli su come eseguire questa operazione, consulta Passaggi di upgrade con l’abilitazione di TLS per RabbitMQ qui di seguito.

  3. Potrebbe essere necessario riavviare il sistema durante un upgrade. Questo si verifica in genere se i file sono bloccati e non possono essere aggiornati dal programma di installazione. Se necessario, ti verrà richiesta dal programma di installazione. In considerazione di questa evenienza, ti consigliamo di effettuare gli upgrade durante le ore non lavorative.

  4. Durante l’upgrade di Resource Monitoring Tool (server e agente), se esegui il programma di installazione come un utente di Windows diverso da quello che ha eseguito l’installazione originale, qualsiasi directory di installazione personalizzata utilizzata inizialmente potrebbe non essere rilevata dall’upgrade e questo verrà installato in una directory diversa.

  5. Talvolta Resource Monitoring Tool modificherà il database. In tali casi, il processo di upgrade includerà una migrazione del database. In caso di migrazione del database, nella parte superiore della pagina Web del server RMT verrà visualizzato un banner dei messaggi con un’indicazione del tempo stimato per il completamento del processo. Di seguito viene mostrata una schermata di esempio:

    Espandendo il banner, puoi vedere i dettagli dell’impatto dell’upgrade. Le modifiche sono uniche per ogni release e i dettagli mostrati sono specifici per la release.

  6. Resource Monitoring Tool è compatibile con le versioni precedenti di Tableau Server, ma non con quelle successive. Ciò significa che la versione di Resource Monitoring Tool deve essere uguale o successiva alla versione di Tableau Server che stai monitorando.

    Per motivi di compatibilità, Tableau consiglia di aggiornare prima Resource Monitoring Tool e poi di eseguire l’upgrade di Tableau Server. Per maggiori informazioni, consulta Compatibilità del prodotto con Tableau Server.

Come eseguire l’upgrade dello Resource Monitoring Tool

Ti consigliamo di eseguire un upgrade sul posto di Resource Monitoring Tool. Se disinstalli Resource Monitoring Tool e installi una nuova versione del database, i dati potrebbero danneggiarsi e ti verrà richiesto di reinstallare la versione precedente e di ripetere il processo di upgrade.

  1. Accedi a Resource Monitoring Tool nel browser e assicurati che stia funzionando prima di iniziare l’upgrade.

  2. Copia la nuova versione del programma di installazione del server RMT nel computer del server RMT.

  3. Copia la nuova versione del programma di installazione dell’agente RMT sui computer in cui sono installati gli agenti RMT. Gli agenti RMT sono installati sui nodi di Tableau Server che stai monitorando.

  4. Su ciascun nodo Tableau Server che esegue il servizio dell’agente RMT, arresta ogni agente RMT utilizzando il seguente comando:

    rmtadmin stop

  5. Sul computer che esegue il servizio server RMT, arresta il server RMT utilizzando il seguente comando:

    rmtadmin stop

  6. In Gestione attività sui computer del server e dell’agente RMT, attendi fino a quando non ci sono più processi in esecuzione con Resource Monitoring Tool, tabrmt-master o tabrmt-agent nel nome prima di passare alla fase successiva.

  7. Esegui il programma di installazione del server RMT sul computer in cui è installato il server RMT. Verranno installati o verrà eseguito l’upgrade di tutti i prerequisiti necessari e quindi del server RMT.

    Non puoi modificare il percorso di installazione in una directory personalizzata durante l’upgrade se Resource Monitoring Tool è già stato installato nel percorso predefinito.

  8. Esegui il programma di installazione dell’agente RMT sul computer in cui sono installati gli agenti RMT.

    Importante: a partire dalla versione 2021.4, è necessario specificare un account utente Esegui come per l’agente RMT. Questo account viene utilizzato per accedere a Tableau Server per la raccolta di informazioni di monitoraggio. Per l’account utente Esegui come, specifica lo stesso account che utilizzi attualmente per l’account utente Esegui come di Tableau Server. Se questo account è stato precedentemente impostato su un account utente personalizzato anziché sull’account predefinito (NT AUTHORITY/Network Service), durante il processo di upgrade verrà ripristinato l’utilizzo dell’account predefinito. Puoi utilizzare il comando rmtadmin service-setup dopo l’installazione per modificarlo nell’account utente personalizzato originale.

  9. Conferma che il server e gli agenti RMT siano in esecuzione. Avvia il server e gli agenti RMT se non vengono riavviati automaticamente al termine dell’upgrade.

  10. Accedi a Resource Monitoring Tool nel browser e verifica che stia funzionando. Se l’installazione non funziona, la causa potrebbe essere un problema relativo all’account utente utilizzato per eseguire l’aggiornamento. Consulta la sezione delle note sull’upgrade all’inizio dell’argomento sull’account utente da utilizzare per l’upgrade.

    Per verificare che gli agenti RMT siano stati aggiornati, vai al menu Admin, seleziona Environments e fai clic sull’icona Edit Environment per vedere i dettagli dell’ambiente. Nella scheda Server puoi visualizzare la versione dell’agente RMT. Ciò può essere utile per determinare di quali agenti RMT è stato eseguito l’upgrade quando esegui un cluster Tableau Server multi-nodo.

Passaggi di upgrade con l’abilitazione di TLS per RabbitMQ

Poiché gli agenti nelle versioni precedenti alla 2022.3 comunicavano utilizzando una connessione non crittografata al servizio per la coda di messaggi RabbitMQ, durante l’upgrade alla versione 2022.3 o successiva, tali agenti devono essere aggiornati per utilizzare i nuovi dettagli di connessione sicura. I passaggi per farlo sono i seguenti:

  1. Dopo aver completato i passaggi di upgrade descritti nella sezione precedente, arresta tutti gli agenti eseguendo il seguente comando:

    rmtadmin stop --agent

  2. Scarica il file bootstrap per l’ambiente eseguendo il seguente comando:

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

  3. Esegui il seguente comando su ogni computer su cui è installato l’agente:

    rmtadmin rotate-mq-certificate <BOOTSTRAP_FILE> --username=<RMT Server Username> --password-file=<RMT Server Password file name>

  4. Riavvia ogni computer dell’agente dopo aver eseguito correttamente il comando rmtadmin rotate-mq-certificate.

Chi può farlo

Per eseguire l’upgrade di Resource Monitoring Tool, devi disporre delle seguenti autorizzazioni:

  • Amministratore sul computer in cui desideri installare Resource Monitoring Tool.
  • Amministratore di Tableau Server.
  • Amministratore di Resource Monitoring Tool.
Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!