Migrazione di database Apache Derby

Gli strumenti di migrazione migrano tutte le istanze Apache Derby nella nuova configurazione e copiano le istanze Apache Derby memorizzate nella struttura di configurazione WebSphere® Application Server della release precedente nella struttura di configurazione della nuova release. Dopo aver utilizzato gli strumenti di migrazione, verificare i risultati della migrazione del database e migrare manualmente le istanze del database o copiare le istanze del database Derby che gli strumenti non migrano o copiano automaticamente.

Prima di iniziare

Per informazioni su come pianificare ed eseguire la migrazione, visitare Knowledge Collection: Migration planning for WebSphere Application Server.

Suggerimenti:
  • Prima di eseguire gli strumenti di migrazione, verificare che tutti i server delle applicazioni che ospitano le applicazioni che utilizzano un database Derby siano chiusi.

    In caso contrario, la migrazione del database non riuscirà.

  • Prima di eseguire gli strumenti di migrazione, assicurarsi che la traccia di migrazione di debug sia attiva.
    Per default, questa funzione di traccia è abilitata. Per riattivare la traccia di migrazione di debug, se è disabilitata, impostare una delle seguenti opzioni di traccia:
    • all traces*=all
    • com.ibm.ws.migration.WASUpgrade=all

Informazioni su questa attività

WebSphere Application Server Versione 9.0 richiede Apache Derby Versione 10.3 o successiva. Apache Derby Versione 10.3 è un server di database Java™ puro che combina il runtime Derby con l'opportunità di utilizzare i servizi completi del supporto software IBM® . Per informazioni complete su Apache Derby Versione 10.3, consultare il sito Web Apache Derby .

Importante: la migrazione da Derby a derby esegue una copia del file system dei dati in un determinato momento. Questa istantanea non rimarrà sincronizzata con il database nell'installazione precedente. Se si esegue il rollback alla release precedente, gli aggiornamenti al database effettuati dopo la migrazione non si rifletteranno nell'installazione precedente.

Procedura

  1. Migrare la configurazione alla Versione 9.0
  2. Verificare che le istanze del database Derby siano state copiate.

    Quando si esegue la migrazione da WebSphere Application Server Versione 7.0 o successiva alla Versione 9.0, gli strumenti di migrazione aggiornano automaticamente le istanze del database Derby a cui si accede tramite il framework incorporato da alcuni componenti interni, come il registro UDDI. Gli strumenti tentano inoltre di aggiornare le istanze Derby a cui accedono le applicazioni tramite il framework integrato. È necessario verificare questi risultati della migrazione dopo l'esecuzione degli strumenti di migrazione.

    • Per distinguere tra una migrazione Derby parzialmente e completamente riuscita, verificare i risultati della migrazione automatica effettuando le seguenti attività:
      1. Controllare il log di post - aggiornamento della migrazione generale per i messaggi di errore del database.

        Queste eccezioni indicano errori di migrazione del database. Lo strumento di migrazione fa riferimento a tutte le eccezioni del database con prefisso DSRA.

      2. Controllare i singoli log di migrazione del database.

        Questi log hanno la stessa data / ora del log di post - aggiornamento della migrazione generale. I singoli log visualizzano ulteriori dettagli sugli errori elencati nel log di post - aggiornamento generale e mostrano gli errori non documentati dal log generale.

        Il nome percorso di ciascun log del database è root_server_app/profiles/profileName/logs/myFulldbPathName_migrationLogtimestamp.log.

      3. Esaminare il log di debug che corrisponde al log di migrazione del database.

        Il programma di utilità di migrazione WebSphere Application Server attiva una traccia di migrazione di debug per impostazione predefinita; questa funzione di traccia genera i log di debug del database.

        Il nome percorso completo di ogni log di debug è app_server_root/profiles/profileName/logs/myFulldbPathName_migrationDebugtimestamp.log.

      L'esecuzione di queste attività fornisce dati diagnostici vitali per la risoluzione dei problemi dei database parzialmente migrati e di quelli che non riescono completamente la migrazione automatica. Infine, è necessario migrare i database che non sono stati completamente migrati automaticamente tramite un processo manuale. I messaggi di log contengono i nomi di percorso del database vecchi e nuovi che devono essere utilizzati per eseguire la migrazione manuale. Notare con precisione questi nuovi nomi di percorso.
    • Verificare che tutte le istanze del database Derby memorizzate nella struttura di configurazione WebSphere Application Server della release precedente siano state copiate nella nuova struttura di configurazione della release

      Controllare il log di post - aggiornamento della migrazione generale per i messaggi di errore del database. Queste eccezioni indicano errori di migrazione del database. Lo strumento di migrazione fa riferimento a tutte le eccezioni del database con prefisso DSRA.

      .
  3. Copiare manualmente le istanze del database Derby dove necessario.
    • Gli strumenti di migrazione Versione 9.0 non tentano di migrare le istanze del database che eseguono transazioni con le applicazioni tramite il framework Apache Derby Network Server. Questa esclusione elimina il rischio di corrompere le applicazioni di terze parti che accedono alle stesse istanze di database a cui accedono WebSphere Application Server.

      Per ridurre il rischio di errori di migrazione per i database che sono stati aggiornati solo parzialmente durante il processo di migrazione automatica, eliminare il nuovo database. Risolvere i problemi del database originale in base ai dati di diagnostica del log, quindi eseguire la migrazione manuale del database originale.

    • Gli strumenti di migrazione Versione 9.0 non copiano alcuna istanza del database Derby all'esterno della struttura ad albero di configurazione di WebSphere Application Server .

      Se la migrazione non copia automaticamente un'istanza del database Derby, copiare manualmente l'istanza del database.

  4. Migrare manualmente il registro UDDI se utilizza un database sul framework Apache Derby Network Server.

    Per ulteriori informazioni, consultare la sezione Migrazione del registro UDDI nella documentazione.

Operazioni successive

Leggere Installazione e configurazione del repository SDO nella documentazione per ulteriori informazioni sull'aggiornamento dell'applicazione del repository SDO alla versione 9.0.