WebSphere Enterprise Service Bus, Version 6.2.0 Systèmes d'exploitation: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Vérification de la migration automatique de Cloudscape v10.1.x

WebSphere ESB version 6.2 nécessite l'exécution d'une version de Cloudscape au moins égale à v10.1.x. (il est à noter que Cloudscape v10.1.x est inclus dans le codebase d'Apache Derby version 10.1) Durant la mise à niveau de WebSphere ESB version 6.2, l'outil de migration met automatiquement à niveau les instances de base de données accessibles à certains composants internes de l'architecture intégrée, tels que le registre UDDI. L'outil tente également de mettre à niveau les instances Cloudscape auxquelles vos applications accèdent via l'architecture intégrée. Les résultats de la migration de ces bases de données dorsales nécessite que vous fassiez une vérification.

Avant de commencer

N'utilisez pas Cloudscape v10.1.x en tant que base de données de production. Utilisez cette base de données uniquement pour les activités de développement et de test.

En savoir plus : La nouvelle version de Cloudscape combine l'environnement d'exécution Derby et des avantages supplémentaires tels que l'assurance qualité IBM® Quality Assurance (QA) et un support multilingue (NLS). Pour plus d'informations sur le code Open source de Cloudscape v10.1.x, consultez les pages Web relatives au produit Cloudscape .

Les outils de migration tentent de mettre à niveau les instances de base de données Cloudscape accessibles via l'architecture intégrée uniquement. La mise à niveau des instances Cloudscape pour lesquels existent des instances avec des serveurs de l'architecture Derby Network Server doit être effectuée manuellement (pour plus d'informations, voir Mise à niveau manuelle de Cloudscape). Cette exigence élimine le risque d'altération des applications tierces qui utilisent l'architecture Network Server pour accéder aux mêmes instances de base de données que WebSphere ESB.

L'accès des autres applications à Cloudscape sur Network Server est possible car l'architecture, contrairement à l'architecture intégrée, fournit un logiciel de connectivité en même temps que la base de données. Cloudscape Network Server peut effectuer des transactions avec plusieurs JVM (Java™ Virtual Machine) (ou serveurs) au même moment, tandis que Cloudscape associée à l'architecture intégrée ne fonctionne qu'avec une seule machine JVM. Les mises en oeuvre regroupées ou coexistantes de WebSphere ESB requièrent Network Server. Pour plus d'informations, voir le centre de documentation IBM Cloudscape.

Pourquoi et quand exécuter cette tâche

Pour les instances de base de données auxquelles vos applications accèdent par le biais de l'architecture imbriquée, la migration automatique peut, selon les cas, aboutir ou échouer entière, ou aboutir avec des avertissements. Une migration entraînant des messages d'avertissement crée bien une base de données Cloudscape v10.1.x avec vos données, mais n'effectue pas la migration de la logique configurée et de tous les autres paramètres, tels que : Pour distinguer une migration complète d'une migration partielle, vous devez vérifier les résultats de la migration automatique en consultant les journaux généraux post-migration et les journaux de base de données individuels. L'exécution de ces tâches vous permet de disposer de données de diagnostic essentielles pour résoudre les incidents affectant les bases de données partiellement migrées, ainsi que celles dont la migration automatique a totalement échoué. En dernier lieu, la migration de ces bases de données s'effectuera manuellement.
Procédure
  1. Ouvrez le journal de post-mise à niveau de chaque nouveau profil WebSphere ESB version 6.2. Le chemin d'accès au fichier journal est racine_installationprofiles/nom_profil/logs/WASPostUpgrade.horodatage.log.
  2. Examinez le fichier journal de post-mise à niveau et recherchez les messages d'erreurs relatifs aux bases de données. Ces exceptions indiquent des échecs lors de la migration des bases de données. Les lignes suivantes sont un exemple de contenu d'un journal postérieur à une mise à niveau, dans lequel le code d'erreur de base de données est DSRA7600E (l'outil de migration fait référence à toutes les exceptions de base de données au moyen du préfixe DSRA).
    MIGR0344I: Processing configuration file /opt/WebSphere60/AppServer/cloudscape
    /db2j.properties.
    
    MIGR0344I: Processing configuration file /opt/WebSphere60/AppServer/config/cells
    /migr06/applications/MyBankApp.ear/deployments/MyBankApp/deployment.xml.
    
    DSRA7600E: Cloudscape migration of database instance /opt/WebSphere61/Express
    /profiles/default/databases/_opt_WebSphere60_AppServer_bin_DefaultDB failed, 
    reason: java.sql.SQLException: Failure creating target db
    
    MIGR0430W: Cloudscape Database /fvt/temp/60BaseXExpress/PostUpgrade50BaseFVTTest9
    /testRun/pre/websphere_backup/bin/DefaultDB failed to migrate <new database name>
    Important : Contactez l'assistance IBM WebSphere ESB si vous constatez la présence d'un message d'erreur de migration concernant une instance Cloudscape un laquelle un composant interne WebSphere a accédé (c'est-à-dire un composant contribuant à contenir WebSphere ESB plutôt que l'une de vos applications).
  3. Ouvrez le journal individuel de migration de base de données associé à chacune de vos bases de données dorsales Cloudscape. Ces journaux sont marqués du même horodatage que celui du journal général de post-mise à niveau. Les journaux contiennent davantage de détails sur les erreurs indiquées dans le journal général de post-mise à niveau et décrivent les erreurs non documentées dans le journal général.

    Le chemin d'accès de chaque journal de base de données est WAS_HOME/profiles/nom_profil/logs/myFulldbPathName_migrationLoghorodatage.log.

  4. Recherchez les erreurs éventuelles dans chaque journal de migration de base de données. Dans le cas d'une migration complète, le journal consigne un message similaire au suivant :
    MIGR0429I: Cloudscape Database F:\temp\60BaseXExpress\PostUpgrade50BaseFVTTest2\testRun
    \pre\websphere_backup\bin\DefaultDB was successfully migrated. See log C:\WebSphere61
    \Express\profiles\default\logs\DefaultDB_migrationLogSun-Dec-18-13.31.40-CST-2007.log
    Dans le cas contraire, le journal consigne les messages d'erreur dans le format de l'exemple suivant :
    connecting to source db <jdbc:db2j:/fvt/temp/60BaseXExpress/PostUpgrade50BaseFVTTest9
    /testRun/pre/websphere_backup/bin/DefaultDB>
    
    connecting to source db <jdbc:db2j:/fvt/temp/60BaseXExpress/PostUpgrade50BaseFVTTest9
    /testRun/pre/websphere_backup/bin/DefaultDB> took 0.26 seconds
    
    creating target db <jdbc:derby:/opt/WebSphere61/Express/profiles/default/databases
    /_opt_WebSphere60_AppServer_bin_DefaultDB>
    
     ERROR: An error occurred during migration. See debug.log for more details.
    
    shutting down databases
    
    shutting down databases took   0.055 seconds
  5. Pour plus d'informations sur une erreur de migration, consultez le journal de débogage correspondant au journal de migration de la base de données. L'utilitaire de migration de WebSphere Application Server déclenche par défaut un débogage de trace de migration. Cette fonction génère les journaux du débogage de base de données. Le chemin d'accès complet à un journal de débogage est WAS_HOME/profiles/nom_profil/logs/myFulldbPathName_migrationDebughorodatage.log.
    Les lignes suivantes montrent un exemple du texte de débogage. Ces lignes comportent des données d'exception détaillées sur l'erreur référencée dans l'exemple de journal de migration de base de données précédent.
    java.sql.SQLException: Database_opt_WebSphere60_AppServer_bin_DefaultDB already exists.
    Aborting migration
    	at com.ibm.db2j.tools.migration.MigrateFrom60Impl.go(Unknown Source)
    	at com.ibm.db2j.tools.migration.MigrateFrom60Impl.doMigrate(Unknown Source)
    	at com.ibm.db2j.tools.MigrateFrom60.doMigrate(Unknown Source)
    	at com.ibm.ws.adapter.migration.CloudscapeMigrationUtility.migr

Résultats

Que faire ensuite

Si une migration partielle a eu lieu, ne tentez de résoudre les incidents affectant la nouvelle base de données v10.1.x que si vous possédez une connaissance approfondie de Cloudscape. Dans le cas contraire, supprimez la nouvelle base de données. Procédez manuellement à la migration de la base de données originale, comme vous le feriez pour chaque base de données dont la migration automatique a échoué. Voir Mise à niveau manuelle de Cloudscape pour obtenir des instructions.

Pour les instances Cloudscape entièrement migrées, sachez que les nouvelles sources de données à portée de cellule ne sont utilisables que par des noeuds exécutant la version 6.0.2 ou une version ultérieure de WebSphere ESB. Les précédentes versions de ce produit ne prennent pas en en charge la nouvelle base de données Cloudscape. Lorsque des applications installées sur des noeuds antérieurs à la version 6.0.2 tentent d'accéder à une source de données Cloudscape 10.1.x, le serveur génère des exceptions au moment de l'exécution.


task Rubrique relative à une tâche

Conditions d'utilisation | Commentaires en retour


Icône d'horodatage Dernière mise à jour: 07 juillet 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tdat_vtv_autocloudsmig.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
Ce centre d'information est mis en service par la technologie Eclipse (http://www.eclipse.org).