/install_directory/ibi/WebFOCUS77/ReportCaster/bin

x

1. Abra el siguiente archivo en el editor de texto:

   /install_directory/ibi/WebFOCUS77/ReportCaster/cfg/rcmigrate.properties

2. En la línea siguiente, especifique la edición desde la que está llevando a cabo la migración:

   source_version=76

   Para las ediciones 5.2.x o 5.3.x, puede introducir 52 o 53 como source_version.

3. Retire los caracteres de comentario de las dos líneas de conexión del repositorio, que corresponden a la base de datos de su repositorio de origen. Estas líneas empiezan por:

   #source_repository_class=
   #source_repository_url=

   Las líneas que empiezan por ## son documentación. Las líneas que empiezan por # son código de ejemplo, que puede ser editado y utilizado; también puede eliminar sus caracteres de comentario. Para eliminar los caracteres de comentario de una línea, borre #.

   Si las líneas de su repositorio no aparecen, añádalas después de las líneas predeterminadas. Para más información sobre las líneas de conexión, consulte Información de conexión del repositorio.

   También debe retirar los caracteres de comentario de las dos líneas posteriores a la línea AS400 del repositorio DB2.

   #source_repository_class=com.ibm.as400.access.AS400JDBCDriver
   #source_repository_url=jdbc:as400://{hostname}/{library_name}

   En cuanto al controlador UDB, retire los caracteres de comentario de las dos líneas posteriores a la línea "DB2 Repository UDB Type 2 Driver".

4. Edite la línea source_repository_url de su repositorio. Por ejemplo:

   • Para el controlador JDBC Universal DB2 de tipo 2 o 4:

     {database_name}

     Elimine { } y sustituya el nombre de la ubicación de su repositorio. En DB2, este es el nombre de la ubicación, no el de la base de datos. (Solo se trata del nombre de la base de datos, cuando el servidor DB2 está en UNIX o Windows).

   • Para FOCUS:

     {hostname:port}

     Elimine { } y sustituya el nombre de host y el puerto del servidor de informes WebFOCUS.

     Por ejemplo:

     source_repository_class=com.ibm.as400.access.AS400JDBCDriver
     source_repository_url=jdbc:as400://iseriesHost/RCAST77

     LOOPBACK

     En el servidor de MVS, reemplace esto por el nombre del servicio.

   {hostname:post}

   Elimine { } y sustituya el nombre de host y el puerto del servidor de la base de datos. Este es el puerto en que escucha la base de datos.

   {database_name}

   Elimine { } y sustituya el nombre de la base de datos, ORASID, o el nombre de la ubicación. Si su base de datos es DB2, es el nombre de la ubicación.

   Elimine { } y sustituya el nombre de la librería.

5. Introduzca la información de inicio de sesión de librería de la base de datos, editando estas dos líneas:

   source_dbowner=
   source_dbpass=

   Este usuario debe tener acceso de creación, lectura y escritura a la base de datos de origen. En repositorios DB2, debería ser el propietario de la base de datos.

6. Compruebe que la línea siguiente contiene un directorio en una partición con espacio de sobra:

   extract_file_path=/install_directory/ibi/WebFOCUS77/ReportCaster/temp

   Las tablas que pertenezcan a una librería que no sea de informes, quedan extraídas en archivos XML en este lugar. Si es necesario, cambie a un lugar que disponga de más espacio. Además, verifique que el usuario que está ejecutando la utilidad de extracción, tiene acceso de escritura a este directorio.

7. Guarde y cierre el archivo.

Las variables siguientes deberían estar predefinidas, pero téngalas en cuenta en caso de que necesite resolver errores en una migración:

target_config_file_path=

Especifica el directorio de configuración que contiene el servidor dserver.xml.

trace_file=

Especifica la ubicación del archivo de seguimiento de la migración. Ejecute las utilidades de migración con un Id. de usuario que pueda escribir en este directorio.

x

Este utilidad de extracción emplea la información de conexión y edición del archivo rcmigrate.properties, para extraer todos los registros, excepto los que están en las tablas de registro o en la Librería de informes. Estos registros quedan extraídos a los archivos XML del equipo en que ha instalado el servidor de distribución.

Para extraer registros o tablas específicos, consulte Pasos de migración de Change Management.

1. Compruebe que el servidor de su base de datos se está ejecutando, antes de intentar extraer datos de la misma. Si estaba utilizando FOCUS, el servidor de informes WebFOCUS y el servidor de base de datos FOCUS (FDS), estarán ejecutándose.
2. Vaya al siguiente directorio:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin

3. Ejecute lo siguiente:

   ./rcextract

   Si no extrae ningún registro, verifique que la información mostrada en el archivo rcmigrate.properties es correcta, y que ha eliminado los caracteres de comentario de las líneas con la información de conexión.

x

Si no está migrando datos de la Librería de informes, consulte Cómo Ejecutar la utilidad de carga. Esta sección hace referencia únicamente a los usuarios de la Librería de informes, que deseen migrar tablas de librería de informes.

Las tablas de librería de informes son de gran tamaño, con datos de tipo BLOB, y no resulta práctico extraerlos a archivos XML en su equipo. En las tablas de librería de informes, cada registro de la librería se extrae y queda preservado en la memoria, al ser cargado en el nuevo repositorio. Por tanto, a la hora de migrar tablas de librería de informes, debe realizar la extracción y la carga en un solo paso. Además, y como cada registro se extrae por separado, el proceso puede ser largo si cuenta con un repositorio de gran tamaño. Puesto que los registro quedan guardados en la memoria, los informes grandes pueden limitar los recursos de su equipo.

Si su librería es muy grande, no es recomendable emplear las utilidades de ReportCaster para migrar la librería. La estructura de las tablas de librería no ha cambiado; le recomendamos que utilice las herramientas nativas SQL de su servidor de base de datos, para migrar estas tres tablas:

BOTCAT
BOTLDATA
BOTLIB

Si va a migrar estas tablas de forma manual, vaya a Cómo Ejecutar la utilidad de carga, para cargar las tablas que no pertenezcan a la librería.

Las bases de datos de origen y de destino deben estar ejecutándose antes de intentar extraer o cargar datos.

Para migrar las tablas de librería mediante la utilidad proporcionada, efectúe lo siguiente:

1. Compruebe que el servidor de su base de datos de origen se está ejecutando, antes de intentar extraer datos de la misma.
2. Compruebe que el servidor de su base de datos de destino se está ejecutando, antes de intentar cargar datos en la misma.
3. Vaya al siguiente directorio:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin

4. Ejecute lo siguiente:

   ./rclibmigrate

5. Elija N, si recibe el siguiente aviso:

   ReportCaster Information has been extracted.
   Do you want to do it again?
   [(Y)es/(N)o (Default No)]: 

   Si no recibe el aviso Sí/No, o escoge Sí, podrá extraer y cargar inmediantamente las tablas de librería y todas las demás tablas, excepto los registros.

x

La utilidad de carga transforma y carga datos de los archivos XML en su base de datos de destino. Debe ejecutar la utilidad, incluso si ya ejecutó una migración de librería, para garantizar que se carguen todas las tablas que no pertenecen a la librería.

1. Compruebe que el servidor de su base de datos de destino se está ejecutando, antes de intentar cargar datos en la misma.
2. Vaya al siguiente directorio:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin

3. Ejecute lo siguiente:

   ./rcload

Si hay filas coincidentes en el repositorio, no quedarán sobrescritas por la utilidad de migración. Si ha ejecutado la utilidad de migración de la Librería de informes, es posible que se ya estén cargadas las tablas que no pertenecen a la librería, y que existan filas coincidentes. Además, si ha sincronizado los Ids. de usuario con Managed Reporting, puede ignorar los errores duplicados, relativos a esos registro. Si desea sobrescribir las filas existentes, puede ejecutar una migración de gestión de cambios solo para estas filas, por medio del comando $REPLACE. Consulte Pasos de migración de Change Management.

x

Esta utilidad es capaz de extraer todos los registros, exceptuando los pertenecientes a la base de datos de origen. Para migrar registro o tablas específicos, use la utilidad Change Managent, como se explica en Pasos de migración de Change Management.

1. Compruebe que el servidor de la base de datos de origen se está ejecutando, antes de intentar extraer datos de la misma.
2. Si su repositorio es muy grande, cierre todos los programas abiertos en su equipo. Cuando los repositorios son grandes, el proceso de migración puede utilizar muchos recursos.
3. Ejecute la utilidad de extracción desde el menú Inicio seleccionando Programas, Information Builders, WebFOCUS77, ReportCaster, Migración y utilidades de bases de datos, Migrar repositorio, y después, Extraer.

   Se abre la ventana Migración: Versión de origen.

4. Especifique la versión y edición del repositorio de origen anterior y pulse Siguiente.

   Se abre la ventana Migración: Archivo de configuración de origen.

   

5. Pulse Examinar, para especificar la ubicación del archivo de origen de la edición anterior de ReportCaster, y pulse Siguiente. El nombre del archivo depende de la edición:

   En ReportCaster 5 o 7: dserver.xmls

   En ediciones anteriores: bkrsched.cfg

   Si no tiene acceso al archivo de configuración de la edición anterior de ReportCaster, seleccione Examinar, para especificar el archivo dserver.xmls actual. A continuación, puede introducir manualmente la información de conexión, en el próximo panel.

   Si su archivo de configuración indica que tenía la Librería de informes, se le pregunta si desea migrar las tablas de librería de informes.

   

   Si su librería tiene un gran número de informes, esta opción no es aconsejable. Consulte Migraciones de Librería de informes, para más información.

6. Si aparece un aviso, especifique si desea migrar los datos de librería.

   Se abre la ventana Migración: Repositorio de origen.

   

   Si introdujo su antiguo archivo de configuración, la información debería aparecer por defecto, aunque debe asegurarse de que el nombre de host es el correcto.

   Si no dispone de su antiguo archivo de configuración, proporcione la información correspondiente. Por ejemplo, cambie el nombre de la base de datos de SQL Server, o el inicio de sesión de Oracle, si está realizando una migración dentro del mismo servidor de base de datos. Si no está seguro de lo que debe introducir, consulte la información pertinente en Temas y tareas adicionales del repositorio de ReportCaster. Al extraer desde un tipo de base de datos distinta, compatible con JDBC, asegúrese de que el controlador JDBC del repositorio de origen esté definido en CLASSPATH, en unidad:\ibi\WebFOCUS77\ReportCaster\bin\classpath.bat. Si necesita añadir el controlador, salga de la utilidad de extracción, añada el controlador y reinicie la utilidad.

   Nota: Si el servidor de distribución está en Windows, añada la page_code de Windows, al final de la línea que define el URL FOCUS. Para inglés, añada ";code_page=137" al final de la línea; por ejemplo, "jdbc:eda:\\hostname:8120;server=EDAUSER;code_page=137". Si está usando el servidor para MVS, compruebe que aparece el nombre correcto del servicio.

7. Pulse Siguiente, si la información de conexión es correcta.

   Se abre la ventana Ubicación de extracción de migración.

   

8. Verifique que hay suficiente espacio en la unidad en que está extrayendo el repositorio. Si es necesario, cambie de ubicación. Las tablas que pertenezcan a una librería que no sea de informes, quedan extraídas en archivos XML de este directorio.

   El procedimiento de migración varía ligeramente, en función de si está migrando la librería de informes:

   • Si no está migrando tablas de la Librería de informes, debe realizar la extracción y la carga por separado; aparece un botón Extraer en la ventana.
   • Si está migrando tablas de la Librería de informes, debe realizar la extracción y la carga en un solo paso; aparece un botón Extraer y cargar en la ventana.
9. Pulse Extraer o Extraer y cargar, para extraer los datos del repositorio de origen.

   Aparece una ventana con información, mientras se realiza la extracción. Revise la información de registro mostrada. Si hay errores, resuélvalos e inténtelo de nuevo.

10. Si quiere guardar esta información de registro, pulse Guardar. De lo contrario, cierre esta ventana y el resto de las ventanas de la utilidad.

    Si no ha migrado la librería, debe ejecutar la utilidad de carga, como se explica más abajo. Si ha migrado las tablas de librería de informes, vaya a Notas de migración.

x

Esta utilidad carga los archivos XML que contienen los datos extraídos de su repositorio de origen. Si decidió migrar la librería, esto se efectuó automáticamente cuando terminó la extracción; puede pasar a Notas de migración.

1. Compruebe que el servidor de su base de datos de destino se está ejecutando, antes de intentar cargar datos en la misma.
2. Ejecute la utilidad de carga desde el menú Inicio seleccionando Programas, Information Builders, WebFOCUS 77, ReportCaster, Migración y utilidades de bases de datos, Migrar repositorio, y después, Cargar.

   Se abre la ventana Carga de migración.

   

3. Si la ubicación de los datos extraídos es correcta, pulse Cargar. Si necesita cambiarla, pulse Examinar y localice el directorio con los datos extraídos en archivos XML.

   Aparece una ventana con información, mientras se realiza la carga. Revise la información de registro mostrada. Si hay errores, resuélvalos e inténtelo de nuevo.

   Si hay registros coincidentes en el repositorio, no quedarán sobrescritos por la utilidad de migración. Si ha sincronizado los Ids. de usuario con Managed Reporting, puede ignorar los errores duplicados, relativos a esos registro. Si desea sobrescribir otros registros existentes, puede ejecutar una migración de gestión de cambios solo para estos registros, por medio de las opciones REPLACE. Para más información, consulte Pasos de migración de Change Management.

4. Si quiere guardar esta información de registro, pulse Guardar. De lo contrario, cierre esta ventana y el resto de las ventanas de la utilidad.