WebSphere ESB versión 6.2 necesita Cloudscape para
ejecutar una versión mínima de v10.1.x. (Tenga en cuenta que Cloudscape v10.1.x consta de
la base del código de Apache Derby Versión 10.1.) Durante la actualización de
WebSphere ESB versión 6.2,
la herramienta de migración actualiza automáticamente las instancias de base de datos a las que algunos componentes internos acceden a
través de la infraestructura incorporada, como el registro UDDI. La herramienta también intenta actualizar instancias de
Cloudscape
a las que las aplicaciones acceden a través de la infraestructura incorporada. Debe verificar los resultados de la migración para estas bases de datos de fondo.
Antes de empezar
No utilice
Cloudscape
v10.1.x como base de datos de producción.
Utilícela sólo con fines de desarrollo y prueba.
Información detallada: La nueva versión de
Cloudscape
combina el tiempo de ejecución de Derby con beneficios adicionales, como
IBM®
Quality Assurance (QA) y el soporte multilingüístico (NLS). Para obtener información acerca de la base de código fuente abierto de Cloudscape v10.1.x, consulte las
páginas Web del producto Cloudscape.
La herramienta de migración intenta actualizar las instancias de base
de datos Cloudscape
a las que se accede únicamente a través de la
infraestructura incorporada. Debe actualizar manualmente las instancias de
Cloudscape
que tratan con servidores de la infraestructura de Derby Network
Server. (Consulte Actualización manual de Cloudscape.) Este requisito evita el riesgo
de dañar aplicaciones de terceros que utilizan la infraestructura de Network Server para acceder a las mismas instancias de base de datos que
WebSphere ESB
Otras aplicaciones pueden acceder a Cloudscape
en Network Server porque la infraestructura proporciona a la base de datos un fundamento de software de
conectividad; la infraestructura incorporada no. Cloudscape
Network Server puede tratar con varios JVM
(Java™ Virtual
Machines) (o servidores) simultáneamente, mientras que
Cloudscape
en la infraestructura incorporada sólo funciona con una única JVM. Las implementaciones de coexistencia o en clúster de WebSphere ESB requieren Network Server. Para obtener más información, consulte el Centro de información de IBM Cloudscape.
Acerca de esta tarea
Para las instancias de base de datos a las que las aplicaciones acceden a través de la infraestructura incorporada, la migración automática puede realizarse satisfactoriamente, sufrir una anomalía o realizarse con avisos. Una migración que produce mensajes de aviso crea una base de datos de
Cloudscape
v10.1.x con los datos, pero no migra toda la lógica configurada y otros
valores, como:
- claves
- comprobaciones
- vistas
- desencadenantes
- alias
- procedimientos almacenados
Para distinguir entre una migración que se ha realizado satisfactoriamente parcial o completamente, debe verificar los resultados de la
migración automática comprobando la anotación cronológica posterior a la actualización general y las anotaciones cronológicas de la base de datos concreta.
Si lleva a cabo estas tareas obtendrá un diagnóstico esencial para resolver los problemas de las bases de datos migradas parcialmente, así como los de las bases de datos cuya migración automática ha fallado completamente. En último término, migre estas bases de datos mediante un proceso manual.
Procedimiento
- Abra la anotación cronológica posterior a la actualización de cada nuevo perfil de WebSphere ESB versión 6.2. El nombre de vía de acceso de la anotación cronológica es
raíz_instalación/profiles/nombre_perfil/logs/WASPostUpgrade.indicación_fecha_hora.log.
- Busque si hay mensajes de error de base de datos en la anotación cronológica posterior a la actualización. Estas excepciones indican anomalías en la migración de la base de datos. Las siguientes líneas son un ejemplo del contenido de la anotación cronológica posterior a la actualización,
en donde el código de error de la base de datos es
DSRA7600E. (La herramienta de migración hace referencia a todas las excepciones de base de datos con el prefijo 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>
Importante: Llame al Soporte técnico de
IBM
WebSphere ESB si ve
un mensaje de anomalía en la migración para una instancia de
Cloudscape
a la que accede un componente interno de
WebSphere
(es decir, un componente que ayuda a incluir
WebSphere ESB en
lugar de una de las aplicaciones del usuario).
- Abra las anotaciones cronológicas de migración de base
de datos que corresponde a cada una de las bases de datos
Cloudscape
de fondo. Estas anotaciones cronológicas tienen la misma indicación de fecha y hora que los de la anotación cronológica general posterior a la actualización. Las anotaciones cronológicas muestran más detalles sobre los errores que se listan en la anotación cronológica general posterior a la actualización, y también muestran errores que no están documentados en la anotación cronológica general.
El nombre de vía de acceso de cada anotación cronológica de base de datos es
WAS_HOME/profiles/nombre_perfil/logs/mi_nombre_vía_acceso_bd_completo_migrationLogindicación_fecha_hora.log.
- Compruebe si existen errores en la anotación cronológica de migración de base de datos. En el caso de una migración completamente satisfactoria, la anotación cronológica muestra un mensaje parecido al siguiente texto:
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-2005.log
De lo contrario, la anotación cronológica muestra mensajes de error en el formato del siguiente ejemplo:
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> ha tardado 0,26 segundos
creación de base de datos de destino <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.
conclusión de bases de datos
conclusión de bases de datos ha tardado 0,055 segundos
- Para obtener más datos sobre un error de migración, consulte la anotación cronológica de depuración que corresponde a la anotación cronológica de migración de base de datos. Por omisión, el programa de utilidad de migración de WebSphere
Application Server desencadena un rastreo de migración de depuración;
esta función de rastreo genera las anotaciones cronológicas de depuración de
base de datos. El nombre de vía de acceso completo de una anotación cronológica de depuración es WAS_HOME/profiles/nombre_perfil/logs/mi_nombre_vía_acceso_bd_completo_migrationDebugindicación_fecha_hora.log.
Las siguientes líneas son un ejemplo del texto de depuración. Las líneas muestran datos de excepción detallados para el error al que se hace referencia en el ejemplo anterior de los datos de la anotación cronológica de migración de base de datos.
java.sql.SQLException: Database_opt_WebSphere60_AppServer_bin_DefaultDB already exists.
Terminando
anormalmente la migración
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
Resultados
- El programa de utilidad de migración de
WebSphere ESB
cambia las configuraciones JDBC de Cloudscape
tanto si migra como si no migra satisfactoriamente las instancias de base de
datos a la que las aplicaciones del usuario acceden. La herramienta cambia las
vías de acceso de clases de proveedor JDBC de
Cloudscape,
las clases de implementación de origen de datos y las clases de ayuda de origen de datos. En la siguiente tabla se muestran estos cambios:
Tabla 1. Nueva información de claseTipo de clase |
Valor antiguo |
Valor nuevo |
Vía de acceso de clases de proveedor JDBC |
${CLOUDSCAPE_JDBC_DRIVER_PATH}/db2j.jar |
${DERBY_JDBC_DRIVER_PATH}/derby.jar- donde DERBY_JDBC_DRIVER_PATH es la variable de entorno de
WebSphere
que define el proveedor JDBC de Cloudscape
- donde derby.jar es el nombre base del archivo de clase de JDBC (en el entorno, haga referencia al archivo de clase de controlador JDBC utilizando el nombre completo).
|
Clase de implementación del origen de datos: agrupación de conexiones |
com.ibm.db2j.jdbc.DB2jConnectionPool DataSource |
org.apache.derby.jdbc.EmbeddedConnection PoolDataSource |
Clase de implementación del origen de datos: XA |
com.ibm.db2j.jdbc.DB2jXADataSource |
org.apache.derby.jdbc.EmbeddedXADataSource |
Clase de ayuda del origen de datos |
com.ibm.websphere.rsadapter.Cloudscape DataStoreHelper |
com.ibm.websphere.rsadapter.Derby DataStoreHelper |
Además el archivo db2j.properties cambia: - El nombre WAS_HOME/cloudscape/dbj.properties se cambia por WAS_HOME/derby/derby.properties
- Dentro del archivo, los nombres de propiedad cambian de db2j.drda.* a derby.drda.*
- Una migración de base de datos parcial o completamente satisfactoria cambia la ubicación y el nombre de la base de datos de acuerdo con el siguiente ejemplo:
- Nombre de base de datos antiguo: c:\temp\mibd
- Nombre de base de datos nuevo: el nuevo nombre incluye un código hash que combina todo el nombre de vía de acceso de la base de datos antigua y la indicación de fecha y hora de migración. El nuevo nombre también incluye el nombre de base de datos antiguo y la indicación de fecha y hora al pie de la letra.Ejemplo: raíz_instalación\profiles\nombre_perfil\databases\mi_bd_hashCode_timestamp
Anote los nombres de vía de acceso exactos: Para las migraciones parciales y anómalas, los mensajes de anotación cronológica contienen los nombres de vía de acceso de base de datos nuevos y antiguos exactos que debe utilizar para ejecutar la migración manual. Anote correctamente estos nombres de vía de acceso nuevos.
Qué hacer a continuación
Si experimenta una migración parcial, intente resolver los problemas
de la nueva base de datos de la versión 10.1.x únicamente si es un experto en
Cloudscape. De lo contrario, suprima la nueva base de datos. Realice el procedimiento de migración manual en la base de datos original, al igual que lo hace para cada base de datos cuya migración automática falla completamente. Consulte el apartado
Actualización manual de Cloudscape para obtener instrucciones.
Para las instancias de Cloudscape
que se han migrado satisfactoriamente, tenga
en cuenta que los nuevos orígenes de datos de ámbito de la célula sólo los
pueden utilizar los nodos que ejecutan la versión 6.0.2 o posterior de
WebSphere ESB. Las versiones anteriores del producto no dan soporte a la nueva base de datos
Cloudscape;
cuando las aplicaciones de los nodos que ejecutan una versión
anterior a la 6.0.2 intentan acceder a un origen de datos de Cloudscape
10.1.x, el servidor emitirá excepciones durante la ejecución.