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:
- dropTriggersDB2.sql
- dropTriggersOracle.sql

Por qué y cuándo se efectúa esta tarea

Antes de migrar la base de datos de transición, ejecute la comprobación previa a la migración para mostrar todos los problemas con la base de datos que podrían causar errores durante la migración. Corrija todos los problemas para asegurarse de que la migración de base de datos se ha completado satisfactoriamente.

Procedimiento

Ejecute la comprobación previa a la migración de la base de datos.
1. Ejecute docker ps para verificar que los contenedores están en ejecución.
2. Localice el nombre del contenedor del programa de utilidad en la columna NAMES. Por ejemplo, myproject_utils_1.
3. Inicie un shell bash ejecutando el mandato siguiente con el nombre del contenedor del programa de utilidad.
  - docker exec -it utility_container_name bash
4. Vaya al directorio bin ejecutando el mandato siguiente.
  - cd WC_installdir/bin
5. 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.
6. 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:
```
/opt/WebSphere/CommerceServer90/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.
```
7. 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.
1. Abra un indicador de mandatos nuevo, o utilice el mismo indicador que ha utilizado para ejecutar la comprobación de base de datos.
2. 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.
```
3. 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.
4. 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.
5. 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.