Aggiornamento a VMware Identity Manager (Windows) APR 2019 VMware Identity Manager 19.03

Transcript

1 Aggiornamento a VMware Identity Manager (Windows) APR 2019 VMware Identity Manager 19.03

2 È possibile trovare la documentazione tecnica più aggiornata sul sito Web di VMware all'indirizzo: Il sito Web di VMware fornisce, inoltre, gli ultimi aggiornamenti di prodotto. In caso di commenti sulla presente documentazione, inviare un messaggio all'indirizzo: VMware, Inc Hillview Ave. Palo Alto, CA VMware, Inc. Centro Leoni Palazzo A Via Spadolini 5 Ground Floor Milan, MI tel: fax: Copyright 2019 VMware, Inc. Tutti i diritti riservati. Informazioni sul copyright e sul marchio commerciale. VMware, Inc. 2

3 Sommario Aggiornamento a VMware Identity Manager (Windows) 4 1 Preparazione per l'aggiornamento 5 Aggiunta del ruolo db_owner prima dell'aggiornamento 7 Disabilitazione dei gruppi di disponibilità AlwaysOn di SQL Server prima dell'aggiornamento 9 Verifica della configurazione del bilanciamento del carico F5 prima dell'aggiornamento 10 2 Aggiornamento del server nel cluster (Windows) 11 3 Configurazione dopo l'aggiornamento 14 Salvataggio delle informazioni di configurazione di un connettore esterno basato su Linux 16 Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows 17 4 Risoluzione dei problemi relativi all'aggiornamento 23 Raccolta di un bundle di file di registro 23 Errore che indica che è necessario l'aggiornamento della configurazione di autenticazione del certificato 24 VMware, Inc. 3

4 Aggiornamento a VMware Identity Manager (Windows) Aggiornamento a VMware Identity Manager (Windows) descrive come aggiornare VMware Identity Manager basato su Windows alla versione dalle versioni precedenti. Per informazioni sull'aggiornamento di VMware Identity Manager per Linux, vedere Aggiornamento a VMware Identity Manager (Linux). Destinatari Queste informazioni sono destinate a chiunque intenda installare, aggiornare e configurare VMware Identity Manager. Sono scritte per amministratori di sistema Windows o Linux esperti che hanno familiarità con la tecnologia delle macchine virtuali. VMware, Inc. 4

5 Preparazione per 1 l'aggiornamento Il processo di aggiornamento non è molto diverso dal processo di installazione. Le impostazioni e i valori configurati vengono compilati automaticamente. È possibile verificare le impostazioni e selezionare Avanti nel programma di installazione. Importante A partire da VMware Identity Manager , il servizio VMware Identity Manager non include più un connettore incorporato e il connettore esterno basato su Linux è deprecato. Le nuove versioni del connettore esterno basato su Linux non sono più disponibili. Se si esegue l'aggiornamento da una distribuzione che utilizza il connettore incorporato, è necessario passare al connettore esterno basato su Windows. Se si utilizza il connettore esterno basato su Linux, è consigliabile passare al connettore esterno basato su Windows durante l'aggiornamento. In caso contrario, non è possibile utilizzare le funzionalità più recenti disponibili nel connettore aggiornato. Se si utilizza il connettore esterno basato su Windows, è possibile continuare a utilizzare le istanze esistenti, ma è consigliabile aggiornare le istanze del connettore esterno basato su Windows per abilitare l'utilizzo delle funzionalità più recenti. VMware Identity Manager connettore per Windows non supporta i pacchetti di VMware ThinApp. Se la distribuzione fornisce l'accesso ai pacchetti ThinApp che si desidera mantenere, non eseguire l'aggiornamento a VMware Identity Manager connettore per Windows. Un pacchetto di migrazione è disponibile per la migrazione delle informazioni sul connettore incorporato o sul connettore esterno basato su Linux al connettore esterno basato su Windows. Quando si esegue il pacchetto di migrazione nel connettore incorporato o nel connettore esterno basato su Linux, tutti i metodi di autenticazione, ad eccezione del metodo di autenticazione Password, sono disabilitati. La disabilitazione consente di aggiornare le impostazioni di configurazione, ad esempio l'indirizzo IP del connettore. Dopo aver installato le istanze del connettore basato su Windows corrispondente, è necessario riabilitare i metodi di autenticazione disabilitati con le impostazioni di configurazione corrette. Percorso di aggiornamento supportato È possibile eseguire un aggiornamento diretto dalla versione o 3.3 alla versione VMware, Inc. 5

6 Per eseguire l'aggiornamento da una versione di VMware Identity Manager precedente alla , è innanzitutto necessario eseguire l'aggiornamento alla versione e quindi eseguire l'aggiornamento dalla versione alla versione Se necessario, eseguire l'aggiornamento alla versione consentita e quindi eseguire l'aggiornamento alla versione Vedere Migrazione di VMware Identity Manager per Windows alla versione Compatibilità con Workspace ONE UEM La matrice di interoperabilità dei prodotti VMware fornisce dettagli sulla compatibilità della versione corrente e di quelle precedenti dei prodotti e dei componenti VMware, ad esempio la console di VMware Workspace ONE UEM. Passaggi preliminari necessari Prima di iniziare l'aggiornamento, assicurarsi di completare i seguenti passaggi. Prima di eseguire l'aggiornamento alla versione più recente, creare uno snapshot del database e dei nodi di VMware Identity Manager. Se si revoca il ruolo db_owner nel database Microsoft SQL, è necessario aggiungere nuovamente il ruolo prima di eseguire l'aggiornamento. In caso contrario, l'aggiornamento non riesce. Vedere Aggiunta del ruolo db_owner prima dell'aggiornamento. Per aggiornare un server di VMware Identity Manager che include i gruppi di disponibilità di SQL server, è necessario disattivare i gruppi di disponibilità prima di aggiornare il server. Dopo l'aggiornamento, è necessario riattivare i gruppi di disponibilità. Vedere Disabilitazione dei gruppi di disponibilità AlwaysOn di SQL Server prima dell'aggiornamento Se la distribuzione di VMware Identity Manager che si sta aggiornando utilizza il connettore incorporato e l'autenticazione basata su certificato, prendere nota delle impostazioni del componente CertificateAuthAdapter configurato nel connettore incorporato. Nota Poiché il connettore incorporato non è più disponibile, anche il componente CertificateAuthAdapter configurato nel connettore incorporato non è più disponibile. Il metodo di autenticazione Certificato (distribuzione cloud) sostituisce il componente CertificateAuthAdapter. Il processo di migrazione gestisce la conversione dal componente CertificateAuthAdapter al metodo di autenticazione Certificato (distribuzione cloud). A questo punto, prima della migrazione, prendere nota delle impostazioni nel componente CertificateAuthAdapter in modo da poter verificare, dopo la migrazione, che le impostazioni precedenti alla migrazione coincidano con le impostazioni successive alla migrazione. a b c Accedere alla console di amministrazione di VMware Identity Manager e selezionare Gestione identità e accessi > Configurazione. Nella pagina Connettori, selezionare il collegamento Worker dell'istanza del connettore incorporato che si sta sostituendo. Fare clic su Adattatori autenticazione e quindi su CertificateAuthAdapter. VMware, Inc. 6

7 d Prendere nota delle impostazioni nella pagina dell'adattatore di autenticazione del servizio del certificato. Se VMware Identity Manager è distribuito in un ambiente con bilanciamento del carico, verificare che l'ambiente sia configurato in modo appropriato. Se si utilizza un server di bilanciamento del carico F5, quando si esegue l'aggiornamento a VMware Identity Manager , riconfigurare il bilanciamento del carico, se necessario. La necessità di riconfigurare il server di bilanciamento del carico F5 dipende dalla versione di VMware Identity Manager da cui si sta effettuando l'aggiornamento. Per aggiornare il server di bilanciamento del carico F5, vedere Verifica della configurazione del bilanciamento del carico F5 prima dell'aggiornamento. Versione di VMware Identity Manager Precedente alla 3.3 Azione necessaria Riconfigurare il server di bilanciamento del carico F5 in base alle istruzioni di riferimento. 3.3 e versioni successive Nessuna. Se si dispone di un server di bilanciamento del carico F5 in esecuzione con VMware Identity Manager 3.3 o versioni successive, il server di bilanciamento del carico è già configurato in modo appropriato. Questo capitolo include i seguenti argomenti: Aggiunta del ruolo db_owner prima dell'aggiornamento Disabilitazione dei gruppi di disponibilità AlwaysOn di SQL Server prima dell'aggiornamento Verifica della configurazione del bilanciamento del carico F5 prima dell'aggiornamento Aggiunta del ruolo db_owner prima dell'aggiornamento Se è stato revocato il ruolo db_owner nel database Microsoft SQL, è necessario aggiungerlo nuovamente prima di eseguire un aggiornamento alla versione più recente di VMware Identity Manager. Prerequisiti Consultare le informazioni sulla creazione del database nella sezione relativa ai prerequisiti di Installazione e configurazione di VMware Identity Manager (Windows). Aggiungere il ruolo db_owner allo stesso utente utilizzato durante l'installazione: Procedura 1 Accedere a Microsoft SQL Server Management Studio come utente con privilegi di sysadmin. 2 Connettersi all'istanza del database per VMware Identity Manager. 3 Immettere i comandi seguenti. Se si utilizza la modalità di autenticazione di Windows, utilizzare i comandi seguenti: USE <saasdb>; ALTER ROLE db_owner ADD MEMBER <domain\username>; GO VMware, Inc. 7

8 Sostituire <saasdb> con il nome del proprio database e <domain\username> con il dominio e il nome utente pertinenti. Se si utilizza la modalità di autenticazione di SQL Server, utilizzare i comandi seguenti: USE <saasdb>; ALTER ROLE db_owner ADD MEMBER <loginusername>; GO Sostituire <saasdb> con il nome del proprio database e <loginusername> con il nome utente pertinente. Modifica dei ruoli a livello di database dopo l'aggiornamento Quando lo schema saas viene utilizzato per creare il database Microsoft SQL per il servizio VMware Identity Manager, al ruolo db_owner viene assegnata l'appartenenza al ruolo di database. I membri del ruolo del database fisso db_owner possono eseguire tutte le configurazioni e le attività di manutenzione sul database. Dopo l'installazione e la configurazione del database nel servizio VMware Identity Manager, è possibile revocare l'accesso a db_owner e aggiungere db_datareader e db_datawriter come ruoli del database. I membri del ruolo db_datareader possono leggere tutti i dati da tutte le tabelle degli utenti. Il membro del ruolo db_datawriter può aggiungere, eliminare e modificare i dati in tutte le tabelle degli utenti. Nota Se si revoca l'accesso a db_owner, assicurarsi di concedere nuovamente il ruolo db_owner prima di iniziare un aggiornamento a una nuova versione di VMware Identity Manager. Prerequisiti Il ruolo utente per Microsoft SQL Server Management Studio come sysadmin o un account utente con privilegi di sysadmin. Procedura 1 Nella sessione di Microsoft SQL Server Management Studio come amministratore con privilegi di sysadmin, connettersi all'istanza di database <saasdb>per VMware Identity Manager. 2 Revocare il ruolo db_owner sul database, immettere il seguente comando Modalità di autenticazione Autenticazione di Windows (dominio\utente) Autenticazione di SQL Server (utente locale) Comando ALTER ROLE db_owner DROP MEMBER <domain\username>; ALTER ROLE db_owner DROP MEMBER <loginusername>; VMware, Inc. 8

9 3 Aggiungere l'appartenenza al ruolo db_datawriter e db_datareader al database. Modalità di autenticazione Autenticazione di Windows (dominio\utente) Comando ALTER ROLE db_datawriter ADD MEMBER <domain\username>; GO ALTER ROLE db_datareader ADD MEMBER <domain\username>; GO Autenticazione di SQL Server (utente locale) ALTER ROLE db_datawriter ADD MEMBER <loginusername>; GO ALTER ROLE db_datareader ADD MEMBER <loginusername>; GO Disabilitazione dei gruppi di disponibilità AlwaysOn di SQL Server prima dell'aggiornamento Se si abilita Microsoft SQL AlwaysOn, prima di aggiornare un server VMware Identity Manager è necessario disabilitare i gruppi di disponibilità. Procedura 1 Nella sessione di Microsoft SQL Server Management Studio come amministratore con privilegi sysadmin, connettersi all'istanza del database per VMware Identity Manager (<saasdb>). 2 Per disattivare i gruppi di disponibilità, immettere il comando seguente. USE master; ALTER AVAILABILITY GROUP <groupname> REMOVE DATABASE <saasdb>; Riattivazione dei gruppi di disponibilità AlwaysOn dopo l'aggiornamento Dopo l'aggiornamento di un server VMware Identity Manager, è necessario attivare nuovamente i gruppi di disponibilità AlwaysOn. Procedura 1 Nella sessione di Microsoft SQL Server Management Studio come amministratore con privilegi sysadmin, connettersi all'istanza del database per VMware Identity Manager (<saasdb>). 2 Per riattivare i gruppi di disponibilità, immettere il comando seguente. USE master; ALTER AVAILABILITY GROUP <groupname> ADD DATABASE <saasdb>; VMware, Inc. 9

10 3 Per risincronizzare tutti i nodi secondari, eseguire il comando seguente. ALTER DATABASE <saasdb> SET HADR AVAILABILITY GROUP = <groupname>; Verifica della configurazione del bilanciamento del carico F5 prima dell'aggiornamento Prima di eseguire l'aggiornamento alla versione più recente del servizio VMware Identity Manger dalla versione 3.2, verificare che il server del bilanciamento del carico F5 sia configurato correttamente. A partire da VMware Identity Manager 3.3, l'intestazione dell'host non può essere null per i controlli di integrità. Assicurarsi che il monitor di controllo dell'integrità F5 creato per l'integrazione del bilanciamento del carico di VMware Identity Manager sia configurato per l'invio della stringa seguente. GET /SAAS/API/1.0/REST/system/health/heartbeat HTTP/1.1\r\nHost: your_workspace_url\r\nconnection: Close\r\n\r\n A partire da VMware Identity Manager 3.3, il server e il connettore di VMware Identity Manager sono configurati in modo da utilizzare solo i pacchetti di crittografia seguenti. Assicurarsi che il server F5 sia configurato con almeno una di questi pacchetti di crittografia. TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA VMware, Inc. 10

11 Aggiornamento del server nel 2 cluster (Windows) Per ogni nodo nel cluster, è necessario aggiornare VMware Identity Manager per Windows. Poiché l'aggiornamento comporterà un determinato tempo di inattività, è consigliabile pianificare l'orario dell'aggiornamento di conseguenza. Importante Se è stato utilizzato il connettore incorporato per una versione di VMware Identity Manager precedente alla e si sta effettuando l'aggiornamento alla versione o successiva, dopo l'aggiornamento è necessario installare il connettore di VMware Identity Manager in un sistema Windows. Per ridurre la quantità di informazioni fornite manualmente durante l'installazione del connettore basato su Windows, durante l'aggiornamento di VMware Identity Manager, consentire a VMware Identity Manager di salvare la configurazione del connettore incorporato per l'esportazione. Prerequisiti Eseguire i prerequisiti descritti in Capitolo 1Preparazione per l'aggiornamento. Nel programma di bilanciamento del carico arrestare tutti i nodi tranne uno. Procedura 1 Scaricare il programma di installazione di VMware Identity Manager SVA per Windows dal sito My VMware all'indirizzo my.vmware.com. 2 Fare doppio clic sul programma di installazione di VMware Identity Manager. Eseguire il programma di installazione da un account con privilegi di amministratore. Dopo un'attesa di alcuni minuti, viene visualizzata una finestra di dialogo in cui viene spiegato che il connettore incorporato non è più disponibile. Il programma di installazione scarica lo script di migrazione migrateembeddedconnector nella cartella Install-Folder\VMwareIdentityManager\support. Se si sceglie l'opzione per salvare la configurazione del connettore incorporato per l'esportazione, il programma di installazione esegue lo script di migrazione automaticamente. VMware, Inc. 11

12 3 Fare clic sulla risposta appropriata per continuare con l'aggiornamento o per salvare la configurazione del connettore incorporato. Opzione Sì Descrizione Per continuare l'aggiornamento senza salvare la configurazione del connettore incorporato. Attenzione Se si continua con l'aggiornamento, il programma di installazione elimina definitivamente la configurazione del connettore incorporato. Non è possibile recuperare la configurazione in un secondo momento. Se non è stato utilizzato il connettore incorporato prima di questo aggiornamento o se è stato utilizzato il connettore incorporato ma è già stata salvata la configurazione del connettore incorporato per l'esportazione, fare clic su Sì. No Per interrompere l'aggiornamento e salvare invece la configurazione del connettore incorporato. Se è stato utilizzato il connettore incorporato prima di questo aggiornamento e non è ancora stato esportato il connettore incorporato, fare clic su No per salvare la configurazione del connettore incorporato in un file. VMware Identity Manager esegue lo script di migrazione migrateembeddedconnector e richiede di esportare la configurazione del connettore incorporato iniziando con la richiesta della password del file del pacchetto di configurazione. 1 Nella casella di testo Password, immettere una password creata autonomamente per il file del pacchetto di configurazione e fare clic su Esporta. Viene visualizzato un messaggio che informa che il processo di esportazione è stato completato correttamente. 2 Fare clic su OK. Il processo genera il file del pacchetto di configurazione, denomina il file cluster-host-domain-conntimestamp.enc e lo salva nella cartella Install-Folder\VMwareIdentityManager. 3 Fare clic su Esci, Sì e Fine per uscire dal processo di esportazione. 4 Eseguire di nuovo il programma di installazione. 4 Per continuare l'aggiornamento, fare clic su Avanti. 5 Accettare il contratto di licenza con l'utente finale (EULA), quindi fare clic su Avanti. 6 Se l'opzione Analisi utilizzo software non è abilitata, viene richiesto se si desidera partecipare al programma. Nella finestra di dialogo Programma di Miglioramento dell'esperienza del Cliente, l'azione predefinita è impostata su Sì. Questo prodotto partecipa al Programma di Miglioramento dell'esperienza del Cliente ("CEIP") di VMware. I dettagli relativi ai dati raccolti tramite il programma CEIP e gli scopi per cui è utilizzato da VMware sono disponibili in Trust & Assurance Center all'indirizzo Se non si intende partecipare al programma CEIP di VMware per questo prodotto, deselezionare la casella. È inoltre possibile partecipare o abbandonare il programma CEIP per questo prodotto in qualsiasi momento dopo l'installazione. Nota Se la rete è configurata per accedere a Internet tramite un proxy HTTP, per inviare a VMware i dati raccolti mediante il programma CEIP, è necessario modificare le impostazioni del proxy nell'host VMware Identity Manager. VMware, Inc. 12

13 7 Verranno elencati i prerequisiti di VMware Identity Manager. Il programma di installazione verifica la presenza dei moduli necessari. e richiede l'installazione dei moduli eventualmente mancanti. 8 Selezionare la directory in cui si desidera installare il servizio VMware Identity Manager. 9 Nella finestra di dialogo Account servizio di VMware Identity Manager, selezionare la casella di controllo se si desidera eseguire il servizio come utente del dominio Windows e immettere il nome utente e la password dell'account del dominio da utilizzare. Il nome utente deve essere nel formato DOMINIO\Nomeutente. Eseguire il servizio come utente del dominio nei casi seguenti. Se si intende connettersi ad Active Directory (autenticazione integrata di Windows). Se si intende utilizzare l'autenticazione Kerberos con il KDC dell'azienda. Se si intende integrare Horizon (View) con VMware Identity Manager e si desidera utilizzare l'opzione Esegui sincronizzazione delle directory. Se non si utilizza un account utente del dominio, il servizio viene eseguito come sistema locale. 10 Fare clic su Installa per iniziare l'aggiornamento. Durante l'aggiornamento, vengono eseguite le azioni seguenti. I file in tale directory vengono aggiornati alla versione più recente di VMware Identity Manager. 11 Fare clic su Fine. Operazioni successive Aggiornare gli altri nodi nel cluster. Se i gruppi di disponibilità di SQL Server sono stati disattivati, attivarli nuovamente. Vedere Riattivazione dei gruppi di disponibilità AlwaysOn dopo l'aggiornamento Se è stato aggiunto il ruolo db_owner per l'aggiornamento, è possibile disattivarlo. Vedere Modifica dei ruoli a livello di database dopo l'aggiornamento Eseguire i passaggi successivi all'aggiornamento. Vedere Capitolo 3Configurazione dopo l'aggiornamento. VMware, Inc. 13

14 Configurazione dopo 3 l'aggiornamento Dopo l'aggiornamento a VMware Identity Manager 3.3, potrebbe essere necessario configurare alcune impostazioni. Configurazione delle istanze di VMware Identity Manager Connector Solo il connettore esterno basato su Windows è disponibile con VMware Identity Manager e versioni successive. Il connettore incorporato non è più incluso. Il connettore esterno basato su Linux è deprecato. Le istanze esistenti del connettore esterno basato su Linux continueranno a essere supportate per una quantità di tempo limitata. Per provare le funzionalità complete del connettore esterno, ovvero entrambe le versioni basata su Windows e basata su Linux, aggiornare tutte le istanze del connettore alla versione più recente del connettore esterno basato su Windows. Installazione di connettori esterni basati su Windows. Eseguire la procedura corrispondente in base al tipo di connettore da cui si sta eseguendo l'aggiornamento. Nota Connettore incorporato. Se è stato utilizzato il connettore incorporato per una versione di VMware Identity Manager precedente alla e si sta effettuando l'aggiornamento alla versione o successiva, è necessario installare il connettore di VMware Identity Manager in un sistema Windows. Per ridurre la quantità di informazioni fornite manualmente, è possibile eseguire le procedure correlate alla migrazione necessarie. Si applica il prerequisito seguente. Durante l'aggiornamento, sono state seguite le istruzioni per salvare la configurazione del connettore incorporato nel file cluster-host-domain-conn-timestamp.enc nella cartella Install- Folder\VMwareIdentityManager. 1 Copiare il file cluster...enc nel sistema Windows in cui si intende installare un'istanza del connettore basato su Windows corrispondente. VMware, Inc. 14

15 2 Durante l'installazione del connettore esterno basato su Windows e successivamente, eseguire passaggi specifici relativi alla migrazione. Utilizzare le informazioni contenute in Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows per completare le istruzioni nella versione corrispondente della guida Installazione e configurazione di VMware Identity Manager Connector (Windows). Connettore esterno basato su Linux. Se sono state utilizzate una o più istanze del connettore esterno basato su Linux per una versione di VMware Identity Manager precedente alla e si sta effettuando l'aggiornamento alla versione o successiva, è possibile continuare a utilizzare le istanze del connettore esistenti. Tuttavia, il connettore esterno basato su Linux è deprecato e non include le funzionalità più recenti. Per utilizzare tutte le funzionalità, installare il rispettivo numero di istanze del connettore di VMware Identity Manager in sistemi Windows. Per ridurre la quantità di informazioni che è necessario fornire manualmente, è possibile eseguire le seguenti procedure correlate alla migrazione. 1 Per salvare le informazioni di configurazione del connettore esterno basato su Linux in un file cluster...enc, in ciascuna istanza del connettore esterno basato su Linux eseguire il pacchetto di migrazione del cluster (cluster-support.tgz). Vedere Salvataggio delle informazioni di configurazione di un connettore esterno basato su Linux. 2 Per trasferire le informazioni di configurazione del connettore esterno basato su Linux archiviate nelle istanze del file cluster...enc alle istanze del connettore esterno basato su Windows, copiare ciascun file cluster...enc in un host Windows corrispondente prima di installare il connettore di VMware Identity Manager nel sistema Windows. Utilizzare le informazioni contenute in Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows per completare le istruzioni nella versione corrispondente della guida Installazione e configurazione di VMware Identity Manager Connector (Windows). 3 Durante l'installazione del connettore esterno basato su Windows e successivamente, eseguire passaggi specifici relativi alla migrazione. Vedere Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows. Connettore esterno basato su Windows. Se sono state utilizzate una o più istanze del connettore esterno basato su Windows per una versione di VMware Identity Manager precedente alla e si sta effettuando l'aggiornamento alla versione o successiva, è possibile continuare a utilizzare le istanze del connettore esistenti. Tuttavia, per garantire la funzionalità completa dei connettori esterni basati su Windows esistenti, aggiornare le istanze del connettore alla versione o successiva. Abilitazione del proxy certificato per Single Sign-on mobile Android per monitoraggio diagnostico Se il Single Sign-on mobile Android è configurato, dopo l'aggiornamento di VMware Identity Manager è necessario abilitare il proxy certificato tramite l'interfaccia utente per attivare il monitoraggio diagnostico. Passare alla pagina Impostazioni dell'appliance> Configurazione proxy certificato Android SSO mobile, quindi scegliere Abilita proxy certificato. Fare clic su Salva. VMware, Inc. 15

16 File di configurazione log4j Se si modificano i file di configurazione log4j in un'istanza di VMware Identity Manager, le nuove versioni dei file non vengono installate automaticamente durante l'aggiornamento. Tuttavia, dopo l'aggiornamento, i registri controllati da tali file non funzioneranno. Per risolvere il problema: 1 Accedere all'host Windows. 2 Cercare i file log4j con il suffisso.rpmnew. find / -name "**log4j.properties.rpmnew" 3 Per ogni file trovato, copiare il nuovo file al posto del file log4j precedente senza il suffisso.rpmnew. Integrazione di Citrix Per l'integrazione di Citrix in VMware Identity Manager 19.03, la versione di tutte le istanze del connettore esterno deve essere o successiva. È inoltre necessario eseguire l'aggiornamento alla versione più recente di Integration Broker. L'aggiornamento non è disponibile per Integration Broker. Disinstallare la versione precedente, quindi installare la nuova versione. Questo capitolo include i seguenti argomenti: Salvataggio delle informazioni di configurazione di un connettore esterno basato su Linux Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows Salvataggio delle informazioni di configurazione di un connettore esterno basato su Linux Per facilitare il passaggio a connettori esterni basati su Windows, è possibile eseguire la migrazione delle informazioni di configurazione dai connettori esterni basati su Linux ai connettori esterni basati su Windows. Se sono state utilizzate una o più istanze del connettore esterno basato su Linux per una versione di VMware Identity Manager precedente alla ed è stato eseguito l'aggiornamento alla versione o successiva, è necessario utilizzare le istanze del connettore esterno basato su Windows. Se si desidera eseguire la migrazione delle informazioni di configurazione dalle istanze del connettore esterno basato su Linux, è necessario raccogliere separatamente le informazioni di configurazione da ciascuna istanza del connettore esterno basato su Linux. VMware, Inc. 16

17 Prerequisiti Scaricare il pacchetto di migrazione del cluster cluster-support.tgz da My VMware o My Workspace ONE a un'istanza dell'appliance virtuale del connettore di cui si intende raccogliere le informazioni di configurazione per la migrazione. Salvare il file nella directory /root. Procedura 1 In qualità di utente root, accedere all'istanza dell'appliance virtuale del connettore di cui si intende raccogliere le informazioni di configurazione per la migrazione. 2 Eseguire un comando nella posizione in cui è stato salvato il file cluster-support.tgz che consenta di decomprimere il file, ad esempio il comando seguente. tar xvfz cluster-support.tgz Il comando estrae due file, uno dei quali è generateclusterfile.sh. 3 Eseguire lo script generateclusterfile.sh con un comando che crea una password, ad esempio il comando seguente../generateclusterfile.sh password Sostituire password con una password di almeno otto caratteri creata autonomamente. La password è necessaria in un secondo momento per eseguire la migrazione delle informazioni di configurazione del connettore esterno basato su Linux quando si configura il connettore esterno basato su Windows corrispondente. Il comando crea un file cluster...enc, ovvero un file crittografato che contiene le informazioni di configurazione del connettore esterno basato su Linux. Operazioni successive Per trasferire le informazioni di configurazione del connettore esterno basato su Linux delle istanze del file cluster...enc alle istanze del connettore esterno basato su Windows, scaricare ciascun file cluster...enc in un host Windows corrispondente prima di installare il connettore di VMware Identity Manager nel sistema Windows. Utilizzare le informazioni contenute in Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows per completare le istruzioni nella versione corrispondente della guida Installazione e configurazione di VMware Identity Manager Connector (Windows). Esecuzione dei passaggi relativi alla migrazione quando si configura il connettore esterno basato su Windows Eseguire le seguenti azioni durante la migrazione delle informazioni di configurazione del connettore incorporato o del connettore esterno basato su Linux durante l'installazione e la configurazione del connettore esterno basato su Windows. Vedere la versione corrispondente della guida Installazione e configurazione di VMware Identity Manager Connector (Windows). VMware, Inc. 17

18 La guida Installazione e configurazione di VMware Identity Manager Connector (Windows) descrive come installare e configurare il connettore esterno basato su Windows. Utilizzare le informazioni seguenti per integrare la guida. L'esecuzione di queste azioni specifiche garantisce quanto segue. Il trasferimento delle informazioni di configurazione del connettore dal connettore incorporato o dal connettore esterno basato su Linux al connettore esterno basato su Windows. La configurazione delle impostazioni disconnesse durante l'aggiornamento di VMware Identity Manager o non gestite dalla migrazione. Prerequisiti Raccogliere un file cluster...enc per ciascun connettore incorporato e ciascuna istanza di connettore esterno basato su Linux che si intende utilizzare per eseguire la migrazione delle informazioni sulla configurazione del connettore durante l'installazione e la configurazione delle istanze del connettore esterno basato su Windows di sostituzione. Salvare ciascun file cluster...enc in un sistema Windows corrispondente che ospiterà un'istanza del connettore esterno basato su Windows di sostituzione. VMware, Inc. 18

19 Procedura Quando si esegue l'installazione guidata di VMware Identity Manager Connector, rispondere in modo appropriato alle domande nelle finestre di dialogo relative alla migrazione. a b Quando viene richiesto il file del pacchetto di configurazione, selezionare Si sta eseguendo la migrazione del connettore? e fare clic su Avanti. Rispondere in base al sistema in uso per individuare il file cluster...enc salvato nell'host e fare clic su Avanti. Elemento della finestra di dialogo Pacchetto di configurazione (.enc) Password Azione Immettere o individuare la posizione del file cluster...enc salvato nell'host. Immettere la password creata per il file cluster...enc durante l'aggiornamento di VMware Identity Manager. VMware, Inc. 19

20 c Quando viene richiesto se si desidera avviare l'installazione guidata di VMware Identity Manager Connector oppure no, fare clic su No per uscire dall'installazione. In questa situazione, fare clic su No è appropriato perché le informazioni di configurazione migrate dal file cluster...enc consentono di completare la configurazione. È necessario fare clic su Sì quando si deve accedere alla console di amministrazione per terminare la configurazione del connettore. d Utilizzare Gestore servizi Windows per riavviare il servizio VMware Identity Manager Connector. Gestore servizi Windows è uno strumento di amministrazione incluso nel sistema operativo Windows. 1 Aprire Gestore servizi Windows. 2 Attendere che lo stato del servizio VMware IDM Connector venga visualizzato come In esecuzione. 3 Riavviare il servizio VMware IDM Connector. VMware, Inc. 20

21 Accedere alla console di amministrazione di VMware Identity Manager, selezionare Gestione identità e accessi > Configurazione, quindi verificare e riconfigurare le impostazioni del connettore. a Verificare che la nuova istanza del connettore esterno basato su Windows sia presente nella pagina Connettori. L'esistenza della nuova istanza del connettore esterno basato su Windows nella pagina Connettori conferma che è abbinata a VMware Identity Manager. b Eliminare l'istanza del connettore che la nuova istanza del connettore esterno basato su Windows sta sostituendo facendo clic sull'icona Elimina accanto all'istanza del connettore che si desidera eliminare e facendo clic su Conferma. L'istanza del connettore viene rimossa dalla console di amministrazione di VMware Identity Manager. Attenzione Eliminare tutte le istanze del connettore di VMware Identity Manager che si stanno sostituendo. La presenza di istanze del connettore che non sono più in uso può interferire con i processi di VMware Identity Manager, in particolare i processi correlati alla directory, come la sincronizzazione e il salvataggio. Se la distribuzione di VMware Identity Manager da cui è stato eseguito l'aggiornamento utilizzava il connettore incorporato e l'autenticazione basata su certificato, verificare che le impostazioni del componente CertificateAuthAdapter siano state correttamente migrate nel metodo di autenticazione Certificato (distribuzione cloud) appena creato. Se questo scenario si applica all'utente corrente, un passaggio preliminare per l'aggiornamento di VMware Identity Manager è stato quello di prendere nota delle impostazioni per il componente CertificateAuthAdapter. Utilizzare queste informazioni per verificare che le impostazioni precedenti alla migrazione nel componente CertificateAuthAdapter coincidano con le impostazioni successive alla migrazione nel metodo di autenticazione Certificato (distribuzione cloud). a b c Nella scheda Gestione identità e accessi selezionare Gestione > Metodi di autenticazione. Nella colonna Configura di Certificato (distribuzione cloud), fare clic sull'icona a forma di matita. Rivedere e, se necessario, modificare le impostazioni nella pagina dell'adattatore di autenticazione del servizio certificati. Per verificare e riconfigurare le directory applicabili in base alle necessità, nella scheda Gestione identità e accessi, fare clic su Gestione ed eseguire i passaggi appropriati relativi alla directory. Attenzione Prima di configurare le directory, verificare che tutte le istanze del connettore che sono state migrate e che ora sono inutilizzate vengano eliminate. La presenza di istanze del connettore che non sono più in uso può interferire con i processi correlati alla directory. a b Fare clic su Sincronizza ora accanto a ogni directory applicabile. Eseguire le modifiche necessarie in base agli aggiornamenti apportati alle directory applicabili e fare clic su Sincronizza directory. VMware, Inc. 21

22 Nella pagina Gestione, fare clic su Provider di identità, fare clic sul nome di un'istanza del provider di identità interessata e aggiornare il valore di Nome host IdP. A causa di fattori imprevedibili nella determinazione dell'host utilizzato, ad esempio perché viene distribuito un bilanciamento del carico, il processo di migrazione non tenta di aggiornare il valore di Nome host IdP. Tenere presenti le situazioni seguenti. Se prima della migrazione è stato utilizzato un bilanciamento del carico per le istanze del connettore e si continua a utilizzare tale bilanciamento del carico, il valore di Nome host IdP non cambia. In tal caso, non aggiornare il valore di Nome host IdP. È invece necessario modificare il bilanciamento del carico in modo che utilizzi le nuove istanze del connettore basate su Windows come membri del bilanciamento del carico. Se prima della migrazione è stato utilizzato l'url di un'istanza del connettore, quindi non è stato utilizzato un bilanciamento del carico, aggiornare il valore di Nome host IdP di conseguenza. Per ulteriori informazioni sulla configurazione delle istanze del provider di identità, vedere la guida all'amministrazione di VMware Identity Manager. a b Fare clic sul nome di un'istanza del provider di identità per cui è necessario aggiornare il valore di Nome host IdP. Nella pagina Provider di identità, modificare il nome host nella casella di testo Nome host IdP e fare clic su Salva. Abilitare i metodi di autenticazione applicabili. Quando è stato eseguito il pacchetto di migrazione nel connettore incorporato o nel connettore esterno basato su Linux, tutti i metodi di autenticazione, ad eccezione del metodo di autenticazione Password, sono stati disabilitati. A questo punto è necessario abilitare di nuovo i metodi di autenticazione disabilitati nel connettore esterno basato su Windows. Vedere la guida Installazione e configurazione di VMware Identity Manager Connector (Windows) per informazioni sull'abilitazione degli adattatori di autenticazione per il connettore. Se applicabile, abilitare la modalità in uscita per il nuovo connettore esterno basato su Windows. Prima della migrazione, se la modalità in uscita non è stata abilitata per il connettore, ad esempio la modalità in uscita non è un'opzione del connettore incorporato, è possibile che si desideri abilitare la modalità in uscita per il nuovo connettore esterno basato su Windows. La procedura prevede l'aggiunta del nuovo connettore esterno basato su Windows al provider di identità integrato e la configurazione di criteri per ogni metodo di autenticazione abilitato. Vedere la guida Installazione e configurazione di VMware Identity Manager Connector (Windows) per informazioni sull'abilitazione della modalità in uscita per il connettore. VMware, Inc. 22

23 Risoluzione dei problemi relativi 4 all'aggiornamento È possibile risolvere i problemi relativi all'aggiornamento esaminando i registri di errore. Se VMware Identity Manager non si avvia, è possibile ripristinare un'istanza precedente eseguendo il rollback di un'istantanea. Questo capitolo include i seguenti argomenti: Raccolta di un bundle di file di registro Errore che indica che è necessario l'aggiornamento della configurazione di autenticazione del certificato Raccolta di un bundle di file di registro È possibile raccogliere un bundle di file di registro. È possibile ottenere il bundle dalla pagina di configurazione dell'apppliance di VMware Identity Manager. Nel bundle vengono raccolti i file di registro seguenti. Tabella 4 1. File di registro Componente Percorso del file di registro Descrizione Registri di Apache Tomcat (catalina.log) Registri del configuratore (configurator.log) Registri del connettore (connector.log) Registri del servizio (horizon.log) /opt/vmware/horizon/workspace/logs/catal ina.log /opt/vmware/horizon/workspace/logs/confi gurator.log /opt/vmware/horizon/workspace/logs/conne ctor.log /opt/vmware/horizon/workspace/logs/horiz on.log Apache Tomcat registra messaggi che non sono registrati negli altri file di registro. Richieste che il configuratore riceve dal client REST e dall'interfaccia Web. Un record di ogni richiesta ricevuta dall'interfaccia Web. Ogni voce del registro include anche l'url della richiesta, il formato data/ora e le eccezioni. Nessuna azione di sincronizzazione viene registrata. Nel registro del servizio vengono registrate le attività che vengono eseguite nell'appliance di VMware Identity Manager, relative ad esempio ai permessi, agli utenti e ai gruppi. VMware, Inc. 23

24 Procedura 1 Accedere alla pagina di configurazione dell'appliance di VMware Identity Manager all'indirizzo 2 Fare clic su Prepara bundle di registri. 3 Scaricare il bundle. Errore che indica che è necessario l'aggiornamento della configurazione di autenticazione del certificato L'aggiornamento non riesce e viene visualizzato un errore che indica che è necessario l'aggiornamento della configurazione di autenticazione del certificato. Problema Quando si tenta di eseguire l'aggiornamento a VMware Identity Manager , viene visualizzato il messaggio di errore seguente e l'aggiornamento viene interrotto. Prima di eseguire l'aggiornamento, è necessario aggiornare la configurazione di autenticazione del certificato per il tenant <tenantname>. Controllo pre-aggiornamento non riuscito. L'aggiornamento verrà interrotto. Causa Questo problema si verifica se i certificati per CertificateAuthAdapter sono stati aggiunti o aggiornati l'ultima volta prima della versione 3.0. Soluzione 1 Accedere alla console di VMware Identity Manager. 2 Passare a Gestione identità e accessi > Configurazione. 3 Nella pagina Connettori fare clic sul collegamento nella colonna Worker. 4 Fare clic su Adattatori autenticazione e quindi su CertificateAuthAdapter. 5 Nella sezione Certificati CA caricati, fare clic sulla X rossa per rimuovere il certificato. 6 Fare clic su Salva. 7 Nella sezione Certificati CA intermedi e root, fare clic su Seleziona file per aggiungere nuovamente il certificato. 8 Fare clic su Salva. 9 Tornare alla console dell'appliance virtuale ed eseguire nuovamente i comandi di aggiornamento. VMware, Inc. 24