Migración de la base de datos de transición IBM Websphere Commerce Version 7
Para migrar la base de datos de transición, ejecute los comandos de comprobación previa a la migración y de migración.
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.
- Para las versiones de HCL Commerce anteriores a la versión 9.1.13.0, descarte los desencadenantes de la política de control de acceso (ACP) que están presentes en la base de datos. Los desencadenantes de ACP que están presentes en la base de datos pueden dar lugar a errores en cualquier trabajo de stagingprop que se ejecute después de la migración de la base de datos. Puede utilizar los scripts SQL proporcionados para descartar estos desencadenantes:
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 están en ejecución.
- 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 [-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 true -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 [-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 true -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.
- Restaure los valores de los parámetros de la base de datos a los valores previos a la migración indicados en el Paso 4 de Preparación para la migración de la base de datos de transición IBM Websphere Commerce Version 7.