Migración de la base de datos de IBM Websphere Commerce Version 7 Feature Pack 6 fuera de línea
Antes de poder migrar los datos de la base de datos en tiempo real de Feature Pack 6 al entorno de IBM Websphere Commerce Version 7 versión 9.0.0.3+, debe migrar una versión fuera de línea a la base de datos de Feature Pack 6, para que pueda realizar las pruebas necesarias de los elementos de Feature Pack 6 migrados.HCL Commerce Version 9 La base de datos de Feature Pack 6 fuera de línea es la base de datos de Feature Pack 6 que ha restaurado en su entorno HCL Commerce Version 9.
El diagrama siguiente muestra el flujo de migración de la base de datos.
![Representación gráfica del flujo de migración de la base de datos.](../images/locale/mg_database.gif)
Antes de empezar
- Asegúrese de que los datos de la tabla KEYS sean válidos. En particular, asegúrese de que las filas que ha añadido para las tablas personalizadas tengan datos válidos.
Por qué y cuándo se efectúa esta tarea
Procedimiento
-
Ejecute la comprobación previa a la migración de la base de datos.
- Ejecute docker ps para verificar que los contenedores se ejecuten.
- Localice el nombre del contenedor del programa de utilidad en la columna NAMES. Por ejemplo, myproject_utils_1.
- Inicie un shell bash ejecutando el mandato siguiente con el nombre del contenedor del programa de utilidad.
docker exec -it <utility_container_name> bash
- Vaya al directorio bin ejecutando el mandato siguiente.
cd WC_installdir/bin
-
Exporte la variable de entorno
ENVTYPE
para que coincida con el tipo de entorno.- exporte ENVTYPE=auth para transición.
- exporte ENVTYPE=Live para producción.
-
Compruebe la base de datos ejecutando el siguiente mandato:
wcim_ant.sh -tier db -action check -from 70 -instanceName instance_name -isStaging true|false [-defaultTablespace yes | no] [-logLevel Error | Warning | Info | Verbose | Debug]
Donde:- tier
- (Opcional) Especifica el nivel de la topología de HCL Commerce que está migrando. La única opción disponible es db.
El valor predeterminado de Tier es db si se deja sin especificar.
- acción
- Especifica la acción que se debe llevar a cabo al ejecutar el mandato. Las acciones soportadas son las siguientes:
- check
- Ejecuta el comprobador previo a la migración de la base de datos para comprobar el estado de la base de datos antes de migrarla. Ejecute el comprobador previo a la migración antes de migrar la base de datos.
- de
- Especifica la versión de la base de datos de HCL Commerce desde la que está migrando. Las únicas opciones disponibles son 70 y 80.
- instanceName
- (Opcional) Especifica el nombre de la instancia de IBM Websphere Commerce Version 7.Nota: El
instanceName
debe ser demo. Este es el predeterminado.El valor predeterminado de InstanceName es demo si se deja sin especificar.
- isStaging
- Especifica si está comprobando la base de datos de transición.
- true
- Está comprobando una base de datos de transición.
- false
- Está comprobando una base de datos que no es de transición.
- defaultTablespace
- Opcional: Especifica si se debe utilizar un espacio de tabla predeterminado para la base de datos.
- sí
- Establece un espacio de tabla predeterminado.
- No
- Se puede utilizar un espacio de tabla no predeterminado. Se le solicita que pase un nombre de espacio de tabla más adelante en la migración.
- logLevel
- Opcional: Especifica la cantidad de información sobre la migración de nivel de base de datos que se anota. Los niveles de registro válidos son los siguientes:
- Error
- Sólo se anotan mensajes de error.
- Aviso
- Todos los mensajes de aviso y de error están anotados.
- Info
- Todos los mensajes de error, aviso y sucesos se anotan.
- Verboso
- Se anotan todos los errores, eventos y otras informaciones, incluida toda la información de sentencia de SQL. Requiere de 1 a 2 MB de almacenamiento para la mayoría de las migraciones. Verboso se establece como valor predeterminado.
- Depuración
- Similar a la opción Verboso, pero incluye información de depuración adicional. Este valor es útil si encuentra errores y necesita depurarlos. Requiere de 1 a 2 MB de almacenamiento para la mayoría de las migraciones.
El siguiente fragmento de código es un ejemplo de las interacciones de la comprobación de base de datos:WC_installdir/bin>wcim_ant.sh -tier db -action check -from 70 -instanceName demo -isStaging false -logLevel Verbose Database type? db2 Database name? mall Is the database backup completed? [ Yes ] (Yes,No,) Yes Is the database restore completed? [ Yes ] (Yes,No,) Yes
Cuando la comprobación se completa satisfactoriamente, verá el mensaje siguiente:INFO: WCIM has completed the job(s) successfully.
- Si la comprobación de la base de datos falla, revise el siguiente archivo de registro: WC_installdir/logs/WCIM/wcim.server.yyyy.mm.dd_hh.mm.ss.log. Ocúpese del mensaje de error y vuelva a ejecutar la comprobación de base de datos.
-
Migre la base de datos.
- Abra un indicador de mandatos nuevo, o utilice el mismo indicador que ha utilizado para ejecutar la comprobación de base de datos.
-
Migre la base de datos ejecutando el mandato siguiente desde el contenedor del programa de utilidad:
wcim_ant.sh -tier db -action migrate -from 70 -instanceName instance_name -isStaging true|false [-defaultTablespace yes | no] [-logLevel Error | Warning | Info | Verbose | Debug]
Donde:- tier
- (Opcional) Especifica el nivel de la topología de HCL Commerce que está migrando. La única opción disponible es db.
El valor predeterminado de Tier es db si se deja sin especificar.
- acción
- Especifica la acción que se debe llevar a cabo al ejecutar el mandato. Las acciones soportadas son las siguientes:
- migrate
- Migra la base de datos a HCL Commerce Version 9.
- de
- Especifica la versión de la base de datos de HCL Commerce desde la que está migrando. Las únicas opciones disponibles son 70 y 80.
- instanceName
- (Opcional) Especifica el nombre de la instancia de IBM Websphere Commerce Version 7.Nota: El
instanceName
debe ser demo. Este es el predeterminado.El valor predeterminado de InstanceName es demo si se deja sin especificar.
- isStaging
- Especifica si está comprobando la base de datos de transición.
- true
- Está migrando una base de datos de transición.
- false
- Está migrando una base de datos que no es transición.
- defaultTablespace
- Opcional: Especifica si se debe utilizar un espacio de tabla predeterminado para la base de datos.
- sí
- Establece un espacio de tabla predeterminado.
- No
- Se puede utilizar un espacio de tabla no predeterminado. Se le solicita que pase un nombre de espacio de tabla más adelante en la migración.
- logLevel
- Opcional: Especifica la cantidad de información sobre la migración de nivel de base de datos que se anota. Los niveles de registro válidos son los siguientes:
- Error
- Sólo se anotan mensajes de error.
- Aviso
- Todos los mensajes de aviso y de error están anotados.
- Info
- Todos los mensajes de error, aviso y sucesos se anotan.
- Verboso
- Se anotan todos los errores, eventos y otras informaciones, incluida toda la información de sentencia de SQL. Requiere de 1 a 2 MB de almacenamiento para la mayoría de las migraciones. Verboso se establece como valor predeterminado.
- Depuración
- Similar a la opción Verboso, pero incluye información de depuración adicional. Este valor es útil si encuentra errores y necesita depurarlos. Requiere de 1 a 2 MB de almacenamiento para la mayoría de las migraciones.
El siguiente fragmento de código es un ejemplo de cómo ejecutar la comprobación de migración de base de datos:WC_installdir/bin>wcim_ant.sh -tier db -action migrate -from 70 -instanceName demo -isStaging false -logLevel Verbose Database type? db2 Database name? mall Is the database backup completed? [ Yes ] (Yes,No,) Yes Is the database restore completed? [ Yes ] (Yes,No,) Yes
Cuando la migración de la base de datos se completa satisfactoriamente, verá el mensaje siguiente:INFO: WCIM has completed the job(s) successfully.
-
Si la migración de la base de datos falla, revise y corrija todos los errores que pueden encontrarse en el siguiente archivo de registro: WC_installdir/logs/WCIM/wcim.server.yyyy.mm.dd_hh.mm.ss.log.
Nota: Si la migración de base de datos falla mientras se habilita el mantenimiento de versiones de contenido, es necesario volver a ejecutar la migración. Para determinar si la migración ha fallado mientras se habilitaba el mantenimiento de versiones de contenido, revise el archivo WC_installdir/logs/WCIM/wcim.server.yyyy.mm.dd_hh.mm.ss.log y el archivo WC_installdir/logs/content.version.update.messages_yyyy.mm.dd_hh.mm.ss.log. Compruebe los registros para ver si la anomalía se produce mientras se ejecuta la tarea
createVersion
desde el archivo configureContentVersionComponent.xml. - Una vez que la migración se ha completado satisfactoriamente, revise todos los avisos en el WC_installdir/logs/WCIM/wcim.server.yyyy.mm.dd_hh.mm.ss.log y, a continuación, determine si es necesario realizar alguna acción.