Migration de bases de données Apache Derby

Les outils de migration migrent toutes les instances Apache Derby vers la nouvelle configuration et copient toutes les instances Apache Derby qui sont stockées dans l'arborescence de configuration WebSphere Application Server de l'édition précédente dans l'arborescence de configuration de la nouvelle édition. Après l'utilisation des outils de migration, vous devez vérifier les résultats de la migration de la base de données et migrer manuellement toutes les instances de base de données ou copier toutes les instances de base de données Derby qui ne sont pas automatiquement migrées ou copiées par les outils.

Avant de commencer

Pour connaître les ressources vous permettant de planifier et d'effectuer la migration, voir Knowledge Collection: Migration planning for WebSphere Application Server.

Conseils :
  • Avant d'exécuter les outils de migration, assurez-vous que tous les serveurs d'applications hébergeant des applications qui utilisent une base de données Derby sont fermés.

    Sinon, la migration de la base de données échouera.

  • Avant d'exécuter les outils de migration, assurez-vous que la trace de débogage de migration est active.
    Par défaut, la fonction de trace est activée. Pour réactiver la trace de débogage de migration si elle est désactivée, définissez l'une des options de trace suivantes :
    • toutes les traces*=all
    • com.ibm.ws.migration.WASUpgrade=all

Pourquoi et quand exécuter cette tâche

WebSphere Application Server Version 9.0 requiert Apache Derby version 10.3 ou ultérieure. Apache Derby version 10.3 est un serveur de base de données pur Java™ qui allie l'environnement d'exécution Derby à la possibilité de bénéficier de tous les services du support logiciel IBM®. Pour obtenir des informations complètes sur Apache Derby version 10.3, consultez le site Web Apache Derby.

Important : La migration de Derby vers Derby effectue une copie des données par le système de fichiers à un instant donné. Cet instantané ne reste pas synchronisé avec la base de données de l'installation précédente. Si vous repassez à la version précédente, les mises à jour apportées à la base de données après la migration ne seront pas reflétées dans l'installation précédente.

Procédure

  1. Migrez la configuration vers la Version 9.0.
  2. Vérifiez que les instances de base de données Derby ont été copiées.

    Lorsque vous migrez depuis WebSphere Application Server Version 7.0 ou ultérieures vers la Version 9.0, les outils de migration mettent automatiquement à jour les instances de base de données Derby auxquelles accèdent certains composants internes, tels que le registre UDDI, via l'infrastructure intégrée. Les outils tentent également de mettre à niveau des instances Derby auxquelles vos applications accèdent via cette même infrastructure. Vous devez vérifier ces résultats de migration après avoir exécuté les outils de migration.

    • Pour faire la distinction entre une migration partiellement réalisée et une autre effectuée avec succès vers Derby, vérifiez les résultats de la migration automatique de la manière suivante :
      1. Recherchez dans le journal général de post-mise à niveau/migration les éventuels messages d'erreur de base de données.

        Ces exceptions indiquent des erreurs de migration des bases de données. L'outil de migration mentionne toutes les exceptions des bases de données avec le préfixe DSRA.

      2. Vérifiez les journaux individuels de migration de la base de données.

        Ces journaux ont un horodatage identique à celui du journal de post-mise à niveau/migration. Ils décrivent les erreurs énumérées dans le journal de post-mise à niveau de façon plus détaillée et répertorient des erreurs qui ne sont pas référencées dans le journal général.

        Le nom du chemin d'accès à chaque journal de base de données est root_serveur_app/profiles/nomProfil/logs/nomCheminCompletBD_migrationLoghorodatage.log.

      3. Consultez le journal de débogage qui correspond au journal de migration de base de données.

        L'utilitaire de migration WebSphere Application Server déclenche par défaut une trace de migration de débogage ; cette fonction de trace génère les journaux de débogage des bases de données.

        Le nom du chemin d'accès complet de chaque journal de débogage est root_serveur_app/profiles/nomProfil/logs/nomCheminCompletBD_migrationDebughorodatage.log.

      De cette façon, vous obtiendrez des données de diagnostic essentielles pour résoudre les problèmes de migration des bases de données, qu'il s'agisse d'une migration partielle ou d'un échec de la migration automatique. Enfin, vous devez migrer les bases de données qui n'ont pas été intégralement migrées via une procédure manuelle. Les messages des journaux contiennent les noms exacts des chemins d'accès aux anciennes et aux nouvelles bases de données que vous devez utiliser pour effectuer la migration manuelle. Notez soigneusement les nouveaux noms de ces chemins d'accès.
    • Vérifiez que les instances de base de données Derby éventuelles stockées dans l'arborescence de configuration WebSphere Application Server de la version antérieure ont été copiées dans celle de la nouvelle version.

      Recherchez dans le journal général de post-mise à niveau/migration les éventuels messages d'erreur de base de données. Ces exceptions indiquent des erreurs de migration des bases de données. L'outil de migration mentionne toutes les exceptions des bases de données avec le préfixe DSRA.

      .
  3. Copiez manuellement des instances de base de données Derby, le cas échéant.
    • Les outils de migration Version 9.0 ne tentent pas de migrer des instances de base de données qui communiquent avec des applications via l'infrastructure Apache Derby Network Server. Cette exclusion permet d'éviter le risque d'altération des applications tierces qui accèdent aux mêmes instances de base de données que WebSphere Application Server.

      Pour réduire le risque d'erreurs de migration des bases de données qui n'ont été mises à niveau que partiellement pendant le processus de migration automatique, supprimez les nouvelles bases de données. Résolvez les problèmes liés à la base de données originale suivant les données de diagnostic du journal, puis migrez-la manuellement.

    • Les outils de migration de la Version 9.0 ne copient pas les instances de base de données Derby ne figurant pas dans l'arborescence de configuration de WebSphere Application Server.

      Si la migration ne copie pas automatiquement d'instance de base de données Derby, copiez l'instance de base de données manuellement.

  4. Faites migrer manuellement votre registre (ou annuaire) UDDI s'il s'appuie sur une base de données accessibles via l'infrastructure Apache Derby Network Server.

    Pour plus d'informations, consultez la rubrique sur la migration du registre UDDI dans la documentation.

Que faire ensuite

Pour plus d'informations sur la mise à niveau de l'application de référentiel SDO vers Version 9.0, consultez la rubrique sur l'installation et la configuration du référentiel SDO dans la documentation.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmig_derby
Nom du fichier : tmig_derby.html