Aggiornamento di VMware Identity Manager Connector. Modificato il 12 OTT 2017 VMware Identity Manager 2.9.2

Transcript

1 Aggiornamento di VMware Identity Manager Connector Modificato il 12 OTT 2017 VMware Identity Manager 2.9.2

2 Aggiornamento di VMware Identity Manager Connector È possibile consultare la documentazione tecnica più aggiornata sul sito Web all'indirizo: Inoltrare eventuali commenti sulla documentazione al seguente indirizzo: VMware, Inc Hillview Ave. Palo Alto, CA VMware, Inc. P.le Biancamano Milano tel: fax: Copyright 2017 VMware Inc. Tutti i diritti sono riservati. Informazioni sul copyright e sui marchi. VMware, Inc. 2

3 Contenuti Aggiornamento di VMware Identity Manager Connector 4 1 Informazioni sull'aggiornamento di VMware Identity Manager Connector 5 2 Preparazione dell'aggiornamento di VMware Identity Manager Connector 6 Prerequisiti per l'aggiornamento 6 Configurazione delle impostazioni del server proxy per l'appliance VMware Identity Manager Connector 7 3 Eseguire un aggiornamento online a Connector versione Esecuzione di un aggiornamento offline di VMware Identity Manager Connector 10 Preparazione di un server Web locale per l'aggiornamento offline 10 Configurazione del connettore ed esecuzione dell'aggiornamento offline 11 5 Risoluzione dei problemi relativi all'aggiornamento 13 Verifica del registro errori dell'aggiornamento 13 Rollback degli snapshot del connettore 14 Raccolta di un bundle di file di registro 14 VMware, Inc. 3

4 Aggiornamento di VMware Identity Manager Connector In Aggiornamento di VMware Identity Manager Connector viene spiegato come aggiornare l'appliance virtuale VMware Identity Manager Connector basata su Linux. Questa guida riguarda le distribuzioni SaaS, in cui viene distribuita in locale un'appliance virtuale del connettore. Riguarda anche le distribuzioni in locale se la distribuzione include ulteriori appliance virtuali del connettore autonome. Destinatari Queste informazioni sono destinate a chiunque installi, aggiorni e configuri l'appliance virtuale VMware Identity Manager Connector. Sono scritte per amministratori di sistema Windows o Linux esperti che hanno familiarità con la tecnologia delle macchine virtuali e le operazioni di data center. Informazioni aggiuntive Per informazioni sull'utilizzo dell'istanza del connettore aggiornata, vedere VMware Identity Manager Amministrazione. Per informazioni sull'aggiornamento di Windows VMware Identity Manager Connector, un componente di VMware Enterprise Systems Connector, vedere Installazione e configurazione di VMware Enterprise Systems. VMware, Inc. 4

5 Informazioni sull'aggiornamento di VMware Identity Manager Connector 1 È possibile aggiornare l'appliance virtuale di VMware Identity Manager Connector online oppure offline. Percorsi di aggiornamento supportati Sono supportati i percorsi di aggiornamento seguenti: Versione e successive fino alla versione Connettività Internet Per impostazione predefinita, il connettore utilizza il sito Web VMware per la procedura di aggiornamento, che richiede che l'appliance del connettore disponga della connettività Internet. È inoltre necessario configurare le impostazioni del server proxy per l'appliance del connettore, se applicabile. Se l'istanza del connettore non dispone di una connessione Internet, è possibile eseguire l'aggiornamento offline. A tale scopo, è sufficiente scaricare il pacchetto dell'aggiornamento e configurare un server Web locale che ospiti il file dell'aggiornamento. VMware, Inc. 5

6 Preparazione dell'aggiornamento di VMware Identity Manager Connector 2 Per preparare l'aggiornamento del connettore, è necessario eseguire un determinato numero di attività prerequisite, ad esempio verificare la disponibilità di aggiornamenti e configurare le impostazioni del server proxy dell'appliance, se disponibile. Questo capitolo include i seguenti argomenti: Prerequisiti per l'aggiornamento Configurazione delle impostazioni del server proxy per l'appliance VMware Identity Manager Connector Prerequisiti per l'aggiornamento Prima di aggiornare il connettore, eseguire queste attività prerequisite. Prerequisiti per l'aggiornamento online Verificare che l'appliance del connettore possa risolvere e raggiungere vapp-updates.vmware.com sulla porta 80 tramite HTTP. Verificare che nella partizione root primaria dell'appliance siano disponibili almeno 4 GB di spazio su disco. Verificare che il connettore sia configurato correttamente. Creare uno snapshot dell'appliance del connettore in modo che funga da backup. Per informazioni sulla creazione di istantanee, vedere la documentazione di vsphere. Se per l'accesso HTTP in uscita è necessario un server proxy HTTP, configurare le impostazioni del server proxy per l'appliance del connettore. Vedere Configurazione delle impostazioni del server proxy per l'appliance VMware Identity Manager Connector. Prerequisiti per l'aggiornamento offline Verificare che sia disponibile un aggiornamento del connettore. Verificare la disponibilità di eventuali aggiornamenti sul sito My VMware Downloads all'indirizzo my.vmware.com. Verificare che nella partizione root primaria dell'appliance siano disponibili almeno 4 GB di spazio su disco. VMware, Inc. 6

7 Aggiornamento di VMware Identity Manager Connector Verificare che il connettore sia configurato correttamente. Creare uno snapshot dell'appliance del connettore in modo che funga da backup. Per informazioni sulla creazione di istantanee, vedere la documentazione di vsphere. Configurare l'appliance del connettore in modo che utilizzi un server Web locale per ospitare il file dell'aggiornamento. Vedere Capitolo 4 Esecuzione di un aggiornamento offline di VMware Identity Manager Connector. Configurazione delle impostazioni del server proxy per l'appliance VMware Identity Manager Connector L'appliance del connettore accede ai server di aggiornamento di VMware tramite Internet. Se la configurazione di rete offre accesso a internet tramite un proxy HTTP, è necessario modificare le impostazioni del proxy per l'appliance. Consentire al proxy di gestire solo il traffico Internet. Per assicurarsi che il proxy sia configurato correttamente, impostare il parametro per il traffico interno su Nessun proxy all'interno del dominio. Nota: I server proxy che richiedono autenticazione non sono supportati. Prerequisiti Verificare di disporre della password root per l'appliance del connettore. Verificare di disporre delle informazioni relative al server proxy. Procedura 1 Accedere all'appliance del connettore come utente root. 2 Immettere YaST nella riga di comando per eseguire la utility YaST. 3 Selezionare Servizi di rete nel riquadro a sinistra, quindi selezionare Proxy. 4 Immettere gli URL del server proxy nei campi URP proxy HTTP e URL proxy HTTPS. 5 Selezionare Fine e uscire dalla utility YaST. 6 Riavviare il server Tomcat nell'appliance virtuale del connettore in modo che utilizzi le nuove impostazioni del proxy. service horizon-workspace restart I server di aggiornamento di VMware sono ora disponibili per l'appliance del connettore. VMware, Inc. 7

8 Eseguire un aggiornamento online a Connector versione È possibile aggiornare l'istanza di VMware Identity Manager Connector online. Nota: I comandi per l'aggiornamento online alla versione sono diversi rispetto a quelli delle versioni precedenti. Assicurarsi di seguire queste istruzioni per eseguire l'aggiornamento alla versione Prerequisiti Sono stati soddisfatti i prerequisiti elencati in Capitolo 2 Preparazione dell'aggiornamento di VMware Identity Manager Connector. Verificare che l'appliance del connettore sia accesa e funzionante. Procedura 1 Accedere all'appliance del connettore come utente root. 2 Eseguire il comando seguente. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Eseguire il comando seguente per aggiornare l'appliance. /usr/local/horizon/update/configureupdate.hzn provider --url I messaggi generati durante l'aggiornamento vengono salvati nel file update.log in /opt/vmware/var/log/update.log. 4 Controllare la versione dell'appliance aggiornata. vamicli version --appliance Verrà visualizzata la nuova versione. 5 Riavviare l'appliance del connettore. reboot VMware, Inc. 8

9 Aggiornamento di VMware Identity Manager Connector 6 Ripetere i passaggi precedenti per ogni appliance del connettore nella distribuzione di VMware Identity Manager. In questo modo, viene completato l'aggiornamento del connettore. VMware, Inc. 9

10 Esecuzione di un aggiornamento offline di VMware Identity Manager Connector 4 Se l'appliance di VMware Identity Manager Connector non è in grado di connettersi a Internet per l'aggiornamento, è possibile eseguire un aggiornamento offline. È necessario configurare un repository di aggiornamento in un server Web locale e configurare l'appliance del connettore per l'utilizzo del server Web locale per l'aggiornamento. Questo capitolo include i seguenti argomenti: Preparazione di un server Web locale per l'aggiornamento offline Configurazione del connettore ed esecuzione dell'aggiornamento offline Preparazione di un server Web locale per l'aggiornamento offline Prima di iniziare l'aggiornamento offline del connettore, preparare il server Web locale creando una struttura di directory che includa una sottodirectory per l'appliance del connettore. Prerequisiti Scaricare il file identity-manager-connector-versionnumber-buildnumber-updaterepo.zip da My VMware. Passare a my.vmware.com, quindi alla pagina di download di VMware Identity Manager Download e scaricare il file disponibile in VMware Identity Manager Connector offline upgrade package. Se si utilizza un server Web IIS, configurarlo in modo che consenta l'utilizzo dei caratteri speciali nei nomi dei file. È possibile configurare questa impostazione nella sezione Filtro richieste selezionando l'opzione Consenti escape doppi. Procedura 1 Creare una directory nel server Web in e copiare in tale directory il file zip scaricato. 2 Verificare che il server Web includa i tipi MIME per.sig (testo/normale) e.sha256 (testo/normale). Senza questi tipi MIME il server Web non può verificare la presenza di aggiornamenti. VMware, Inc. 10

11 Aggiornamento di VMware Identity Manager Connector 3 Decomprimere il file. I contenuti del file ZIP estratto vengono gestiti da I contenuti estratti del file contengono le sottodirectory seguenti: /manifest e /package-pool. 4 Eseguire il comando updatelocal.hzn seguente per verificare che l'url includa contenuti di aggiornamento validi. /usr/local/horizon/update/updatelocal.hzn checkurl Configurazione del connettore ed esecuzione dell'aggiornamento offline Configurare l'appliance del connettore in modo che punti al server Web locale per eseguire un aggiornamento offline. Aggiornare quindi l'appliance. Prerequisiti Preparazione di un server Web locale per l'aggiornamento offline. Procedura 1 Accedere all'appliance del connettore come utente root. 2 Eseguire il comando seguente per configurare un repository di aggiornamento che utilizzi un server Web locale. /usr/local/horizon/update/updatelocal.hzn seturl Nota: Per annullare la configurazione e ripristinare l'impostazione per l'esecuzione di un aggiornamento online, è possibile eseguire il comando seguente. /usr/local/horizon/update/updatelocal.hzn setdefault 3 Eseguire l'aggiornamento. a Eseguire il comando seguente. /usr/local/horizon/update/updatemgr.hzn updateinstaller b Eseguire il comando seguente per verificare la versione dell'aggiornamento disponibile. /usr/local/horizon/update/updatemgr.hzn check VMware, Inc. 11

12 Aggiornamento di VMware Identity Manager Connector c Eseguire il comando seguente per aggiornare il connettore. /usr/local/horizon/update/updatemgr.hzn update I messaggi generati durante l'aggiornamento vengono salvati nel file update.log in /opt/vmware/var/log/update.log. d Eseguire nuovamente il comando updatemgr.hzn check. /usr/local/horizon/update/updatemgr.hzn check e Controllare la versione dell'appliance aggiornata. vamicli version --appliance Il comando dovrebbe consentire di visualizzare la nuova versione. f Riavviare l'appliance del connettore. Ad esempio, dalla riga di comando eseguire il comando seguente. reboot 4 Ripetere i passaggi precedenti per ogni appliance del connettore della distribuzione di VMware Identity Manager. In questo modo, viene completato l'aggiornamento del connettore. VMware, Inc. 12

13 Risoluzione dei problemi relativi 5 all'aggiornamento È possibile risolvere i problemi relativi all'aggiornamento esaminando i registri di errore. Se il connettore non si avvia dopo l'aggiornamento, è possibile ripristinare un'istanza precedente eseguendo il rollback di uno snapshot. Questo capitolo include i seguenti argomenti: Verifica del registro errori dell'aggiornamento Rollback degli snapshot del connettore Raccolta di un bundle di file di registro Verifica del registro errori dell'aggiornamento È possibile correggere gli errori che si verificano durante l'aggiornamento esaminando i registri errori. I file dei registri dell'aggiornamento si trovano nella directory /opt/vmware/var/log. Problema Al termine dell'aggiornamento, il connettore non si avvia e nei registri degli errori vengono visualizzati messaggi di errore. Causa Gli errori si sono verificati durante l'aggiornamento. Soluzione 1 Accedere all'appliance del connettore. 2 Passare alla directory /opt/vmware/var/log. 3 Aprire il file update.log ed esaminare i messaggi di errore. 4 Correggere gli errori ed eseguire nuovamente il comando di aggiornamento. Il comando di aggiornamento riprende dal punto in cui era stato interrotto. Nota: In alternativa, è possibile ripristinare uno snapshot ed eseguire nuovamente l'aggiornamento. VMware, Inc. 13

14 Aggiornamento di VMware Identity Manager Connector Rollback degli snapshot del connettore Se il connettore non si avvia correttamente dopo l'aggiornamento, è possibile eseguire il rollback di un'istanza precedente. Problema L'istanza del connettore non si avvia correttamente dopo l'aggiornamento. Si esamina il registro errori dell'aggiornamento e si esegue nuovamente il comando di aggiornamento, ma il problema persiste. Causa Durante il processo di aggiornamento si sono verificati errori. Soluzione u Ripristinare uno degli snapshot creati come backup dell'istanza del connettore originale. Per informazioni, consultare la documentazione di vsphere. Raccolta di un bundle di file di registro È possibile raccogliere un bundle di file di registro da inviare al supporto VMware. Il bundle può essere ottenuto dalla pagina di configurazione del connettore. Nel bundle vengono raccolti i file di registro seguenti. Tavola 5 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) /opt/vmware/horizon/workspace/logs/catal ina.log /opt/vmware/horizon/workspace/logs/confi gurator.log /opt/vmware/horizon/workspace/logs/conne ctor.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. Procedura 1 Accedere alla pagina di configurazione del connettore all'indirizzo /cfg/logs. 2 Fare clic su Prepara bundle di registri. 3 Scaricare il bundle e inviarlo al supporto VMware. VMware, Inc. 14