Migración de bases de datos de Apache Derby

Las herramientas de migración migran las instancias de Apache Derby a la nueva configuración, y copian las instancias de Apache Derby almacenadas en el árbol de configuración del release anterior de WebSphere Application Server en el árbol de configuración del nuevo release. Tras utilizar las herramientas de migración, compruebe los resultados de la migración de bases de datos y migre manualmente las instancias de bases de datos o copie las instancia de base de datos Derby que las herramientas no migren o copien automáticamente.

Antes de empezar

Si desea recursos que le ayuden a planificar y llevar a cabo la migración, visite Knowledge Collection: Migration planning for WebSphere Application Server.

Consejos:
  • Antes de ejecutar las herramientas de migración, asegúrese de que se han cerrado los servidores de aplicaciones que alojan aplicaciones que utilizan la base de datos Derby.

    En caso contrario, la migración de la base de datos fallará.

  • Antes de ejecutar las herramientas de migración, asegúrese de que la opción para depurar el rastreo de migración esté activa.
    De forma predeterminada, esta función de rastreo está habilitada. Para reactivar la depuración del rastreo de migración si está desactivado, establezca las siguientes opciones de rastreo:
    • all traces*=all
    • com.ibm.ws.migration.WASUpgrade=all

Acerca de esta tarea

WebSphere Application Server Versión 9.0 requiere Apache Derby Versión 10.3 o posterior. Apache Derby versión 10.3 es un servidor de bases de datos Java™ puro que combina el módulo de ejecución Derby con la oportunidad de utilizar todos los servicios del Servicio de soporte de software de IBM®. Para obtener información completa sobre Apache Derby Versión 10.3, consulte el sitio web de Apache Derby.

Importante: En un punto determinado, el proceso de migración de Derby a Derby realiza una copia de los datos en el sistema de archivos. Esta instantánea no estará sincronizada con la base de datos de la instalación anterior. Si realiza una retrotracción al release anterior, las actualizaciones que haya realizado en la base de datos después de la migración no se verán reflejadas en la versión anterior.

Procedimiento

  1. Migre la configuración a la Versión 9.0.
  2. Compruebe que se hayan copiado las instancias de la base de datos Derby.

    Al migrar de WebSphere Application Server Versión 7.0 o posterior a Versión 9.0, las herramientas de migración actualizan automáticamente las instancias de base de datos Derby a las que algunos componentes internos, como el registro UDDI, acceden a través de la infraestructura incluida. Las herramientas también intentan actualizar instancias de Derby a las que las aplicaciones acceden a través de la infraestructura incorporada. Después de ejecutar las herramientas de migración, debe verificar los resultados de la migración.

    • Para distinguir entre una migración parcial de Derby y una que ha finalizado completamente, realice las tareas siguientes para verificar los resultados de la migración automática:
      1. Consulte el registro posterior a la actualización de la migración general para determinar si contiene algún mensaje de error.

        Estas excepciones indican un error de migración de base de datos. La herramienta de migración hace referencia a todas las excepciones de la base de datos con el prefijo DSRA.

      2. Consulte los registros individuales de migración de la base de datos.

        Estos registros tienen la misma indicación de fecha y hora que el registro posterior a la actualización de la migración general. Los registros individuales muestran más detalles sobre los errores indicados en los registros generales posteriores a la actualización, y exponen errores no documentados en el registro general.

        El nombre de la vía de acceso de cada registro de la base de datos es raíz_servidor_aplicaciones/profiles/nombrePerfil/logs/nombreVíaAccesoCompletaBaseDatos_migrationLogindicaciónFechaHora.log.

      3. Busque el registro de depuración que corresponde al registro de migración de la base de datos.

        El programa de utilidad de migración de WebSphere Application Server desencadena de forma predeterminada un rastreo de migración de depuración; esta función de rastreo genera los registros de depuración de la base de datos.

        El nombre de vía de acceso completo de cada registro de depuración es raíz_servidor_aplicaciones/profiles/nombrePerfil/logs/nombreVíaAccesoCompletaBaseDatos_migrationDebugindicaciónFechaHora.log.

      Al realizar estas tareas se obtienen datos de diagnóstico muy importantes para solucionar los problemas de las bases de datos migradas parcialmente, así como de las migraciones automáticas que finalizan completamente pero con error. Finalmente, debe migrar a través de un proceso manual las bases de datos que no se han migrado por completo automáticamente. Los mensajes de registro contienen el nombre exacto de la vía de acceso de la base de datos anterior y nueva que debe utilizar para realizar la migración manual. Anotes correctamente estos nombres de vía de acceso nuevos.
    • Verifique que las instancias de bases de datos Derby almacenadas en el árbol de configuración del release anterior de WebSphere Application Server se hayan copiado en el árbol de configuración del nuevo release.

      Consulte el registro posterior a la actualización de la migración general para determinar si contiene algún mensaje de error. Estas excepciones indican un error de migración de base de datos. La herramienta de migración hace referencia a todas las excepciones de la base de datos con el prefijo DSRA.

      .
  3. Copie manualmente las instancias de la base de datos Derby si fuera necesario.
    • Las herramientas de migración de Versión 9.0 no intentan migrar instancias de base de datos que negocian con aplicaciones a través de la infraestructura Apache Derby Network Server. Esta exclusión impide que se corrompan las aplicaciones de terceros que acceden a las mismas instancias de base de datos a que las que accede WebSphere Application Server.

      Para minimizar el riesgo de errores de migración para bases de datos que sólo se han actualizado de forma parcial durante el proceso de migración automática, suprima la base de datos nueva. Solucione el problema con la base de datos original de acuerdo con los datos de diagnóstico del registro y, a continuación, realice una migración manual de la base de datos original.

    • Las herramientas de migración de la Versión 9.0 no copian ninguna instancia de base de datos Derby que se encuentre fuera del árbol de configuración de WebSphere Application Server.

      Si la migración no copia automáticamente la instancia de base de datos Derby, cópiela manualmente.

  4. Migre manualmente el registro UDDI si éste utiliza una base de datos en una infraestructura Apache Derby Network Server.

    Consulte el tema sobre la migración del registro UDDI en la documentación para obtener más información.

Qué hacer a continuación

Consulte el tema sobre la instalación y configuración del repositorio de SDO en la documentación para obtener más información sobre la actualización de la aplicación del repositorio de SDO a Versión 9.0.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmig_derby
File name: tmig_derby.html