Migrazione delle celle utilizzando gli strumenti della 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.

Prima di iniziare

Questo argomento riguarda la migrazione della configurazione dei profili, in particolare la migrazione delle celle sullo stesso host.

Per risorse utili alla pianificazione e all'esecuzione della migrazione, consulta la Raccolta di conoscenze: Pianificazione della migrazione per WebSphere Application Server.

Contenuti multimediali Per i video sulla migrazione delle celle, consultare i video "Amministrazione di WebSphere : migrazione delle celle tramite gli strumenti da riga di comando " nella playlist "Migrazione di WebSphere : utilizzo della riga di comando". I passaggi descritti in questa sezione non riguardano la migrazione di un clone. I video illustrano le fasi della migrazione dei cloni. Per evitare una migrazione tramite clonazione, non impostare il -clone parametro opzionale su true nel comando WASPostUpgrade di migrazione.

Evita problemi: assicurati che l'impostazione del numero massimo di file aperti sia pari o superiore a 10000. Se il numero di file aperti è troppo basso, ciò può causare vari errori di migrazione.

Informazioni su questa attività

La configurazione della cella è composta da un deployment manager con uno o più nodi, un server web e un client applicativo. Tutte le porte vengono migrate nella nuova configurazione. Questa procedura presuppone che la configurazione precedente sia in esecuzione.

Per migrare una configurazione di cella, eseguire WASPreUpgrade, WASPostUpgrade, manageprofiles, e altri comandi di migrazione descritti nella sezione " Utilizzo degli strumenti di migrazione ". È possibile specificare singoli parametri nei comandi di migrazione oppure indicare il -propertiesfile_name.properties parametro per caricare un file di proprietà.

Procedura

  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. Passa alla deployment_manager_profile_root/bin directory.
    2. Esegui il backupConfig comando con i parametri appropriati e salva 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 nella 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 la versione 9.0 di WebSphere Application Server 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 del gestore di distribuzione di destinazione è un nuovo profilo del gestore di distribuzione che sarà l'obiettivo 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 nuova directory del bin profilo 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 solo prima WASPreUpgrade del completamento se si fornisce -keepDmgrEnabled true nella riga di comando o si specifica 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 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 in fase di migrazione: 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. Controllare gli avvisi o gli errori nell'output della console e WASPreUpgrade nei log.

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

      Se ci sono 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 completato con successo, non è necessario controllare i log per errori o avvisi.

  5. Ripristina la configurazione precedente del gestore di distribuzione salvata nella directory di backup della migrazione eseguendo il WASPostUpgrade comando.

    Se si utilizzano le opzioni mostrate nell'esempio seguente, tutte le porte vengono trasferite, il vecchio gestore di distribuzione viene chiuso 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 i profili, solo uno di essi viene considerato il profilo predefinito per ogni installazione.

      È possibile identificare i profili predefiniti consultando il profileRegistry.xml file nella WAS_HOME/properties directory. La fonte profileRegistry.xml viene copiata nella directory di backup della migrazione come parte del WASPreUpgrade comando.

      Evita problemi: specifica sempre i -oldProfile parametri -profileName e quando esegui il WASPostUpgrade comando.
    2. Controllare gli avvisi o gli errori nell'output della console e WASPostUpgrade nei log.

      Una volta completato il WASPostUpgrade comando, controlla l'output della console perFailed with errorsoCompleted with warningsmessaggi. Se l'output contiene uno dei due messaggi, controllare i file di migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.log migration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace log e per verificare la presenza di eventuali avvisi o errori. Se ci sono 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 completato con successo, non è necessario controllare i log per 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 problemi: questo è un passo importante nel piano di migrazione cellulare. Se si verificano errori nella migrazione dei nodi, è possibile ripristinare la configurazione della cella al punto precedente all'errore, applicare le azioni correttive e riprovare a eseguire la migrazione dei nodi.
    1. Passa alla deployment_manager_profile_root/bin 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 bin directory dei profili del gestore di distribuzione 9.0.
    2. Esegui il startManager comando.
    3. Mentre il gestore di distribuzione è in esecuzione, controllare il SystemOut.log file per eventuali 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.logactivity.log , trace.log e sui sistemi distribuiti e IBM® i. È inoltre possibile utilizzare HPEL insieme alle funzionalità di registrazione native di z/OS®. Se si utilizza HPEL, è possibile accedere a tutte le informazioni di log e tracciamento utilizzando lo strumento da riga di comando LogViewer dalla directory bin del profilo server. Per ulteriori informazioni sull' uso di HPEL, consultare le informazioni relative alla risoluzione dei problemi delle applicazioni tramite HPEL.
    4. Controllare tutti i log dell'agente del nodo e del server delle applicazioni del nodo per verificare la presenza di nuovi avvisi o errori.
      Se la sincronizzazione automatica è abilitata, consentire al nodo di sincronizzarsi, consentire alle applicazioni di riavviarsi, quindi controllare i registri per eventuali nuovi avvisi o errori.
  8. Migrare le installazioni dei client dell'applicazione.

    Migrare le risorse dei clienti alle 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 WASPreUpgrade9.0 ` 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 WASPostUpgrade 9.0 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 di configurazione del nodo corrente in una directory di backup della migrazione. Specificare una nuova directory per i file di backup, la directory root 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. Controllare gli avvisi o gli errori nell'output della console e WASPreUpgrade nei log.

      Controlla l'output WASPreUpgrade della console per verificare la presenza di messaggi del tipoFailed with errorsoCompleted with warnings. Se il comando non è stato eseguito correttamente, controllare i seguenti file di log per 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.
    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. Controllare gli avvisi o gli 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 log per individuare eventuali 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 Version 9.0 dal file backupConfig. Se WASPostUpgrade l'elaborazione ha eseguito il syncNode comando, il gestore di distribuzione è consapevole che il nodo è stato migrato. Il nodo non può essere migrato nuovamente fino a quando il gestore di distribuzione non viene ripristinato 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 SystemOut.log gestore 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.logactivity.log , trace.log e sui sistemi distribuiti e IBM i. È inoltre possibile utilizzare HPEL insieme alle funzionalità di registrazione native di z/OS. Se si utilizza HPEL, è possibile accedere a tutte le informazioni di log e tracciamento utilizzando lo strumento da riga di comando LogViewer dalla directory bin del profilo server. Per ulteriori informazioni sull' uso di HPEL, consultare le informazioni relative alla risoluzione dei problemi delle applicazioni tramite HPEL.
    9. Avvia l'agente del nodo della versione 9.0 dopo la migrazione.
    10. Controlla se sono presenti avvisi o errori nel file di versione del gestore di SystemOut.log distribuzione 9.0 e e nel file del nodo.
    11. Sincronizza la cella.
    12. Arrestare tutti i server delle applicazioni sul nodo migrato con versione 9.0.
    13. Avviare i server delle applicazioni appropriati sul nodo migrato di Version 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. Migrazione dei 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 server web in uso.

    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 vengano 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".

Risultati

Hai effettuato la migrazione da una versione precedente a una versione di WebSphere Application Server ( 9.0 ) utilizzando gli strumenti di migrazione.