Migrazione delle celle tramite gli strumenti da riga di comando

È possibile utilizzare gli strumenti da riga di comando per migrare una cella da una versione precedente di WebSphere® Application Server alla versione 9.0.

1. Eseguire il backup del gestore di distribuzione e di tutti i nodi precedenti.

   In caso di errore durante la migrazione, salvare la configurazione corrente del gestore di distribuzione e del nodo in un file che potrà essere utilizzato in seguito per il ripristino utilizzando il comando backupConfig comando.

   1. deployment_manager_profile_root/bin Passa alla directory.
   2. Eseguire il backupConfig comando con i parametri appropriati e salvare la configurazione corrente del profilo del gestore di distribuzione in un file.

      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70dmgr01/bin/backupConfig 
      /mybackupdir/v70dmgr01backupBeforeV90migration.zip 
      -username myuser -password mypass -nostop

   3. Per ogni nodo della configurazione, passare alla node_profile_root/bin directory.
   4. Esegui il backupConfig comando con i parametri appropriati e salva la configurazione corrente del profilo del nodo in un file.

      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70node01/bin/backupConfig 
      /mybackupdir/v70node01rbackupBeforeV90migration.zip 
      -username myuser -password mypass -nostop

2. Installa WebSphere Application Server Versione 9.0 in una nuova directory su ogni macchina di destinazione.

   Per ulteriori informazioni, consultare la documentazione relativa all'installazione.

3. Creare il profilo del gestore di distribuzione di destinazione eseguendo il manageprofiles comando con i parametri appropriati.

   Il profilo di gestione delle distribuzioni di destinazione è un nuovo profilo di gestione delle distribuzioni che costituirà la destinazione della migrazione.

   /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName v90dmgr01 
   -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/profileTemplates/management 
   -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName -cellName currentCellName 
   -hostName mydmgrhost.company.com

4. Salvare la configurazione corrente del gestore di distribuzione nella directory di backup della migrazione eseguendo il WASPreUpgrade comando dalla directory del nuovo profilo bin del gestore di distribuzione.

   Il WASPreUpgrade comando non modifica la configurazione di Version 7.0 o o versioni successive. Per ulteriori informazioni, consultare il comando WASPreUpgrade.

   Nota: se stai effettuando la migrazione dalla versione 8.0 o successive alla versione 9.0 e il tuo profilo è quello di un responsabile della distribuzione, il profilo della versione 8.0 verrà disattivato quando esegui il WASPreUpgrade comando. Il gestore di distribuzione viene avviato prima WASPreUpgrade del completamento solo se si specifica -keepDmgrEnabled true nella riga di comando o si seleziona l'opzione corrispondente nella procedura guidata di migrazione.
   1. Eseguire il WASPreUpgrade comando specificando la directory di backup della migrazione, la directory principale di installazione di Version 7.0 o o versioni successive e il nome del profilo del gestore di distribuzione.

      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/v70toV90dmgr01 
      /QIBM/UserData/WebSphere/AppServer/V9/ND -oldProfile v70dmgr01

      Per gli utenti che stanno effettuando la transizione: nelle versioni precedenti alla versione 9.0, veniva specificata la directory principale dell'istanza o del profilo di origine anziché la directory di installazione. Nella versione 9.0, specificare il nome del profilo nel -oldProfile parametro.
   2. Controlla eventuali avvisi o errori nell'output della console e WASPreUpgrade nei log.

      Una volta completato il WASPreUpgrade comando, controlla l'output della console per verificare seFailed with errorsoCompleted with warningsmessaggi. Se l'output contiene uno dei due messaggi, controllare i WASPreUpgrade.old_Profile.timestamp.log file di log e WASPreUpgrade.trace per verificare la presenza di eventuali avvisi o errori.

      Se vengono rilevati degli errori, correggili ed esegui nuovamente il WASPreUpgrade comando. Verificare se gli avvisi influiscono su altre attività di migrazione o di esecuzione nella versione 9.0.

      Se il comando è stato eseguito correttamente, non è necessario controllare i registri alla ricerca di errori o avvisi.

5. Ripristina la configurazione precedente di Deployment Manager che hai salvato nella directory di backup della migrazione eseguendo il WASPostUpgrade comando.

   Se si utilizzano le opzioni illustrate nell'esempio seguente, tutte le porte vengono trasferite, il vecchio gestore di distribuzione viene arrestato e disabilitato e tutte le applicazioni vengono installate. Per ulteriori informazioni, consultare il comando WASPostUpgrade.

   1. Esegui il WASPostUpgrade comando.

      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90dmgr01 -oldProfile v70dmgr01 
      -profileName v90dmgr01 -resolvePortConflicts incrementCurrent -backupConfig true 
      -includeApps true -keepDmgrEnabled false -username myuser -password mypass

      Quando si creano dei profili, solo uno di essi viene considerato il profilo predefinito per ogni installazione.

      È possibile individuare i profili predefiniti consultando il profileRegistry.xml file nella WAS_HOME/properties directory. Il file sorgente profileRegistry.xml viene copiato nella directory di backup della migrazione come parte del WASPreUpgrade comando.

      Per evitare problemi: specificare sempre i -oldProfile parametri e -profileName quando si esegue il WASPostUpgrade comando.
   2. Controlla eventuali avvisi o errori nell'output della console e WASPostUpgrade nei log.

      Una volta completato il WASPostUpgrade comando, controlla l'output della console per verificare seFailed with errorsoCompleted with warningsmessaggi. Se l'output contiene uno dei due messaggi, controllare i migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.log file di log e migration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace per verificare la presenza di eventuali avvisi o errori. Se vengono rilevati degli errori, correggili ed esegui nuovamente il WASPostUpgrade comando. Verificare se gli avvisi influiscono su altre attività di migrazione o di esecuzione nella versione 9.0.

      Se la configurazione è stata migrata correttamente ma alcune applicazioni non sono state installate, è possibile eseguire il WASMigrationAppInstaller comando per installare solo le applicazioni che non sono state migrate. Per ulteriori informazioni, consultare il comando WASMigrationAppInstaller.

      Se il comando è stato eseguito correttamente, non è necessario controllare i registri alla ricerca di errori o avvisi.

6. Eseguire il backup della configurazione del gestore di distribuzione di Version 9.0 in un file eseguendo il backupConfig comando sul gestore di distribuzione di Version 9.0.
   Evita i problemi: questo è un passo importante nel piano di migrazione delle celle. Se si verificano errori durante la migrazione dei nodi, è possibile ripristinare la configurazione della cella allo stato precedente all'errore, applicare le misure correttive e riprovare a eseguire la migrazione dei nodi.
   1. deployment_manager_profile_root/bin Passa alla directory
   2. Esegui il backupConfig comando con i parametri appropriati.

      /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile/bin/backupConfig.sh 
      /mybackupdir/v70toV90dmgr01backupMigratedDmgrOnly.zip 
      -username myuser -password mypass

7. Avvia il gestore di distribuzione Version 9.0.

   Assicurarsi che la versione precedente del gestore di distribuzione non sia in esecuzione.

   1. Passa alla nuova versione nella directory del profilo bin del gestore di distribuzione 9.0.
   2. Esegui il startManager comando.
   3. Mentre il gestore delle distribuzioni è in esecuzione, controllare il SystemOut.log file per verificare la presenza di avvisi o errori.
      Nota: questo argomento fa riferimento a uno o più file di log del server delle applicazioni. Come alternativa consigliata, è possibile configurare il server in modo che utilizzi l'infrastruttura di log e tracciamento HPEL (High Performance Extensible Logging) anziché i file SystemOut.log , SystemErr.log, trace.log, e activity.log sui sistemi distribuiti e su quelli con architettura " IBM® i ". È inoltre possibile utilizzare HPEL insieme alle funzionalità di registrazione native di. z/OS®. Se utilizzi HPEL, puoi accedere a tutte le informazioni relative ai log e alle tracce utilizzando lo strumento da riga di comando ` LogViewer `, disponibile nella directory `bin` del profilo del tuo server. Per ulteriori informazioni sull ' uso di HPEL, consultare le informazioni relative alla risoluzione dei problemi delle applicazioni tramite HPEL.
   4. Controlla tutti i log dell'agente del nodo e del server delle applicazioni per verificare la presenza di nuovi avvisi o errori.
      Se la sincronizzazione automatica è abilitata, attendere che il nodo si sincronizzi, consentire il riavvio delle applicazioni e quindi controllare i registri per verificare la presenza di nuovi avvisi o errori.
8. Eseguire la migrazione delle installazioni client delle applicazioni.

   Migrare le risorse dei clienti verso risorse di livello " 9.0 ".

   1. Installare il client dell'applicazione " WebSphere " versione 9.0.

      Per ulteriori informazioni, consultare la documentazione relativa all'installazione.

   2. Eseguire il comando "Version 9.0WASPreUpgrade " per salvare le impostazioni di sicurezza del client dell'applicazione in una directory di backup di migrazione.

      /opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70

   3. Eseguire il comando "Version 9.0WASPostUpgrade " per ripristinare le impostazioni di sicurezza del client dell'applicazione sul nuovo client "Version 9.0 ".

      /opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90 

9. Migrare i nodi.

   Utilizza gli strumenti di migrazione per aggiornare le versioni precedenti dei nodi presenti nella configurazione alla versione 9.0. Eseguire la procedura seguente per ogni nodo che si intende migrare alla versione 9.0.

   Per evitare problemi: è necessario utilizzare lo stesso nome del nodo di origine, ma un nome di cella temporanea diverso per ogni nodo che si migra alla versione 9.0.
   1. Assicurarsi che il gestore di distribuzione Version 9.0 sia in esecuzione.
   2. Creare il profilo del nodo di destinazione. Esegui il manageprofiles comando con i parametri appropriati per creare un nuovo profilo gestito.

      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create 
      -profileName currentNode1Name -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/profileTemplates/managed 
      -nodeName currentNode1Name -cellName tempCellName -hostName mynode1host.company.com

   3. Eseguire il WASPreUpgrade comando per salvare le informazioni relative alla configurazione del nodo corrente in una directory di backup di migrazione. Specificare una nuova directory per i file di backup, la directory principale di installazione e il profilo del nodo.

      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade 
      /mybackup/v70toV90node1 /QIBM/UserData/WebSphere/AppServer/V7/ND -oldProfile 70node1

   4. Controlla eventuali avvisi o errori nell'output della console e WASPreUpgrade nei log.

      Controlla l'output WASPreUpgrade della console per messaggi del tipoFailed with errorsoCompleted with warnings. Se il comando non è stato eseguito correttamente, controllare i seguenti file di log per individuare eventuali errori o avvisi.

      • migration_backup_dir/logs/WASPreUpgrade.old_profile.timestamp.log
      • migration_backup_dir/logs/WASPreUpgrade.trace

      Se il WASPreUpgrade comando è stato eseguito correttamente, non è necessario controllare i log alla ricerca di errori o avvisi.

   5. Arrestare l'agent nodo.
      Se durante la migrazione alla versione 9.0 sono in esecuzione nodi con versione 7.0 o successive, è necessario arrestare l'agente del nodo sul nodo oggetto della migrazione. Se non si arresta l'agente del nodo, potrebbero verificarsi problemi di danneggiamento dei dati.
   6. Esegui il WASPostUpgrade comando per ripristinare la configurazione del nodo salvata nel nuovo profilo gestito di Version 9.0.

      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90node1 
      -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent 
      -backupConfig true -username myuser -password mypass

   7. Controlla eventuali avvisi o errori nell'output della console e WASPostUpgrade nei log.

      Controlla l'output WASPostUpgrade della console perFailed with errorsoCompleted with warningsmessaggi. Se nell'output compare uno dei due messaggi, controlla i seguenti file di log per verificare la presenza di errori o avvisi.

      • migration_backup_dir/logs/WASPostUpgrade.target_profile.timestamp.log
      • migration_backup_dir/logs/WASPostUpgrade.target_profile.trace

      Nota: se il WASPostUpgrade comando non va a buon fine, potrebbe essere necessario ripristinare il gestore di distribuzione di Version 9.0 dal file backupConfig. Se il WASPostUpgrade processo ha eseguito il syncNode comando, il gestore della distribuzione è a conoscenza del fatto che il nodo è stato migrato. Il nodo non potrà essere migrato nuovamente finché il gestore della distribuzione non sarà riportato allo stato precedente alla migrazione del nodo.

      Se la configurazione è stata migrata correttamente ma alcune applicazioni non sono state installate, è possibile eseguire il WASMigrationAppInstaller comando per installare solo le applicazioni che non sono state migrate. Per ulteriori informazioni, consultare il comando WASMigrationAppInstaller.

      Se il comando è stato eseguito correttamente, non è necessario controllare i log alla ricerca di errori o avvisi.

   8. Controlla se nel file del gestore SystemOut.log di distribuzione " 9.0 " sono presenti avvisi o errori.
      Nota: questo argomento fa riferimento a uno o più file di log del server delle applicazioni. Come alternativa consigliata, è possibile configurare il server in modo che utilizzi l'infrastruttura di registrazione e tracciamento HPEL (High Performance Extensible Logging) invece dei file SystemOut.log , SystemErr.log, trace.log, e activity.log sui sistemi distribuiti e su quelli con architettura " IBM i ". È inoltre possibile utilizzare HPEL insieme alle funzionalità di registrazione native di z/OS. Se utilizzi HPEL, puoi accedere a tutte le informazioni relative ai log e alle tracce utilizzando lo strumento da riga di comando ` LogViewer `, disponibile nella directory `bin` del profilo del tuo server. Per ulteriori informazioni sull ' uso di HPEL, consultare le informazioni relative alla risoluzione dei problemi delle applicazioni tramite HPEL.
   9. Avvia l'agente di nodo della versione 9.0 migrata.
   10. Verificare la presenza di avvisi o errori nel file di versione del gestore di distribuzione 9.0 e e nel file del nodo SystemOut.log .
   11. Sincronizza la cella.
   12. Arrestare tutti i server delle applicazioni sul nodo migrato in versione 9.0.
   13. Avviare i server delle applicazioni appropriati sul nodo migrato con versione 9.0.
   14. Salvare la configurazione del profilo di Version 9.0 in un file eseguendo il backupConfig comando con i parametri appropriati.

       /QIBM/UserData/WebSphere/AppServer/V9/profiles/v70toV90node1/bin/backupConfig 
       /mybackupdir/v70toV90node1.zip -username myuser -password mypass -nostop

       Ogni volta che esegui il backupConfig comando, utilizza un nuovo nome per il file di backup.
   15. Salvare la configurazione del gestore di distribuzione in un file eseguendo il backupConfig comando con i parametri appropriati.
       Prima di eseguire il comando, passare alla deployment_manager_profile_root/bin directory sull'host del gestore di distribuzione Version 9.0.

       Nota: per ogni nodo migrato, eseguire il backup della configurazione del gestore di distribuzione "Version- 9.0 " in un nuovo file di backup.

       /QIBM/UserData/WebSphere/AppServer/V9/profiles/currentDmgrName/bin/backupConfig.sh 
       /mybackupdir/v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip 
       -username myuser -password mypass

10. Migrare i plug-in per i server web.

    Il prodotto supporta diversi server web, come indicato nei requisiti di sistema. Per informazioni sull'installazione, consultare la documentazione relativa al tipo e alla versione del proprio server web.

    1. Assicurarsi che il gestore di distribuzione Version 9.0 sia in esecuzione.
    2. Aggiornare la versione del plug-in del server web utilizzato nella cella.
    3. Per tutti i server delle applicazioni presenti nella cella che si desidera siano gestiti dal server web, creare una nuova definizione del server web per il plug-in del server web.
       Per ulteriori informazioni sulla creazione di definizioni di server Web, consultare la sezione "Implementazione di un plug-in per server Web".