Prácticas probadas de IBM Cognos : Comparación de su entorno IBM Cognos 8 por medio de IBM Cognos Upgrade Manager

Producto(s): IBM Cognos Upgrade Manager; Area of Interés: Application Lifecycle, IBM Cognos 8, IBM Cognos Reportnet

Durante el ciclo de vida de su aplicación IBM Cognos 8 usted quizá necesite actualizar IBM Cognos 8 con un Service Pack, Fix Pack, hotsite u otro actualizador de IBM Cognos. Este documento puede utilizarse para suministrar un enfoque guiado.

Greg McDonald, Product Manager, IBM

Como administrador de productos para el IBM Cognos Platform team, Greg McDonald administra dispositivos centrados en IT, servicios compartidos y tecnologías de infraestructura de la cartera de software de IBM Cognos. Con 11 años de experiencia, Greg es responsable de Application Lifecycle y Content Manager, además de las actualizaciones generales a la plataforma de Cognos.



06-01-2011

Introducción

Objetivo

Durante el ciclo de vida de su aplicación IBM Cognos 8 usted quizá quiera actualizar IBM Cognos 8 con un Service Pack, Fix Pack, hotsite u otro actualizador de IBM Cognos. Su departamento de IT quizá desee además informarle sobre las actualizaciones a la base de datos que van a realizarse o sobre actualizaciones a otras infraestructuras que pueden afectar inadvertidamente en entorno de su informe, o más específicamente, sus informes. En muchos de estos casos, la validación del informe es obligatoria. Usted debe asegurarse de que lo que está aplicando a su entorno, ya sea un producto de IBM Cognos o no, no afecta la forma en la que se ven los informes o los datos que surgen de los mismos. Aquí es donde IBM Cognos Upgrade Manager puede ayudar. IBM Cognos Upgrade Manager pueden ayudarlo a identificar rápidamente dónde hay diferencias de datos en un informe y si los datos provocan algún cambio de formato, el IBM Cognos Upgrade Manager puede identificar estos también. Si “No existen diferencias” que comparar en el estado de los informes, entonces se sugiere una comprobación rápida para asegurarse de que no hayan ocurrido cambios de formato. Por ejemplo, si una tabla o un gráfico estuviera desplazada del centro, esto puede no haber sido señalado como una diferencia por IBM Cognos Upgrade Manager.

Aplicabilidad

Las técnicas presentadas y analizadas en este documento se validaron usando:

  • IBM Cognos Upgrade Manager 8.4 e IBM Cognos BI 8.4.29.13

Sin embargo, usando IBM Cognos Upgrade Manager 8.4, esta misma técnica puede utilizarse para validar informes de versiones anteriores.

Advertencias

Es importante tener en cuenta que IBM Cognos Upgrade Manager envía una solicitud a una aplicación de IBM Cognos 8 para ejecutar informes, no se fija en el contenido guardado. Por lo tanto, al realizar una comparación con propósitos de validación es necesario asegurarse de que la validación ocurra durante un momento en el cual los datos todavía están frescos. Si los datos cambian entre el momento de la ejecución de la fuente y el momento de la ejecución de del destino, IBM Cognos Upgrade Manager marcará diferencias que quizá no sean las que usted realmente desea para completar la validación.

Exclusiones y excepciones

IBM Cognos Upgrade Manager actualmente no soporta informes de validación dentro de un entorno IBM Cognos 8 que está protegido por Single Sign On (SSO).


Los pasos para preparar su entorno

Preparación de IBM Cognos 8.x para recibir un actualizador

Antes de instalar una actualización para su entorno IBM Cognos 8.x debería hacer lo siguiente:

  • Tome el backup del almacén de contenido usando un método probado de backup específico de base de datos. Usted debería probar el backup de la base de datos antes de proceder.
  • Asegúrese de tomar el despliegue de contenido completo de IBM Cognos Administration.
  • Tome un backup del sistema de archivos. Esto asegurará que pueda volver adonde se encontraba anteriormente si lo necesita.
  • Realice el backup de los archivos que puede haber personalizado en su estructura de directorio de IBM Cognos 8.

Al asegurarse de tener buenos backups, en caso de ser necesario, usted puede restaurar su configuración/entorno anterior con facilidad.

Preparación de su entorno para actualizaciones no pertenecientes a IBM Cognos

Antes de prepararse para validar su entorno, debería usar las mejores prácticas de los vendors para realizar el backup de la aplicación o el componente que está actualizando. Por ejemplo, si usted está realizando una actualización a la base de datos informativa, debería realizar el backup de la misma y probar lo restaurado. De esta forma usted quizá deba restaurar la versión o configuración, y puede hacer esto rápida y fácilmente.


Configuración de IBM Cognos Upgrade Manager

En esta sección le ayudaremos a configurar IBM Cognos Upgrade Manager de modo que el entorno fuente y destino se refieran a una única fuente de IBM Cognos 8. Esto nos permitirá tomar de antemano capturas de pantallas de sus informes antes de que la aplicación de IBM Cognos 8 haya realizado la actualización o la aplicación de la tercera parte haya aplicado las actualizaciones a la misma. Una vez que se ha tomado la captura de pantalla anticipada, su entorno puede actualizarse y luego IBM Cognos Upgrade Manager nuevamente será utilizado para tomar la captura de pantalla posterior de modo que estas puedan compararse y validarse como si no tuvieran diferencias.

Instalación y configuración de Upgrade Manager

La instalación y configuración de IBM Cognos Upgrade Manager se registra bien en ug_upgr_mngr.pdf, el cual puede descargarse desde Passport Advantage. Por favor consulte en este documento sobre puertos por omisión modificados, javaheap y otros escenarios configurables.

Al buscar IBM Cognos Upgrade Manager en Passport Advantage se recomienda utilizar el siguiente criterio de búsqueda: “IBM Cognos 8 Business Intelligence Upgrade Manager v8.4.1 Windows English(C1XC4EN)”. Esto lo ayudará a encontrar la versión adecuada. Una vez que la ha descargado, debería instalarla en un servidor que tenga al menos 1 GB de RAM libre. IBM Cognos Upgrade Manager utiliza su propia instancia Tomcat y se configura para usar 768MB de RAM. Instale IBM Upgrade Manager en su propio directorio, no lo instale en el directorio de IBM Cognos 8. IBM Cognos Upgrade Manager envía solicitudes a su instancia de IBM Cognos 8 y luego almacena el resultado de la ejecución, en formato pdf, en forma local. Una operación de validación de informe requiere 2 archivos pdf. Para la comparación de 1000 informes se necesitan 2000 archivos pdf, etc. Debido a esto, asegúrese de instalar IBM Cognos Upgrade Manager a un servidor con amplio expacio en disco.

  1. Una vez que el Upgrade Manager ha sido descargado, descomprímalo a un directorio a su elección. Navegue al directorio win32 y ejecute el archivo issetup.exe.
  2. Decida donde instalar la aplicación IBM Cognos Upgrade Manager.
    Figura 1 Pantalla de instalación de IBM Cognos Upgrade Manager que muestra la necesidad proyectada de espacio de disco y el directorio de instalación
    Figura 1 Pantalla de instalación de IBM Cognos Upgrade Manager que muestra la necesidad proyectada de espacio en disco y el directorio de instalación
  3. Una vez que haya instalado el producto, navegue a la ubicación ..\UpgradeManager para hechar un vistazo al lugar donde los archivos del proyecto están siendo ubicados. En este caso el pdf y otros archivos de soporte serán almacenados en el directorio C:\Program Files\cognos\UpgradeManager\data\projects\ . Cada proyecto que usted cree constituirá una carpeta en este directorio para sus archivos.

Configuración de Upgrade Manager para el proyecto de comparación

Comenzaremos configurando IBM Cognos Upgrade Manager para eliminar las marcas de fecha, y fecha/hora que pudieran causar la indicación de diferencias cuando en realidad no las hay. Nosotros hacemos esto especificando un valor estático de fecha/hora en informes ejecutados de modo que los valores de fecha/hora diferentes no aparezcan al comparar el resultado de la fuente y del destino.

Para eliminar las marcas de fecha, y fecha/hora haga lo siguiente:

  1. Detenga el servicio de IBM Cognos 8.
  2. En el servidor donde está instalado IBM Cognos 8, navegue al directorio install_location\configuration. Realice una copia de backup de rsvpproperties.xml.sample.
  3. Utilizando un editor de texto, abra el archivo rsvpproperties.xml.sample.
  4. Localice la propiedad StaticDateTimeOutput.
  5. Borre las etiquetas de comentarios del xml alrededor de la propiedad. Una vez completada la entrada debería observarse lo siguiente:
    <property>StaticDateTimeOutput</property> <value type="long">1060180744</value>
  6. Guarde el archivo como rsvpproperties.xml.
  7. Inicie el servicio de IBM Cognos 8.

Ahora debemos crear el proyecto en IBM Cognos Upgrade Manager y configurarlo para usar nuestra instalación de IBM Cognos 8.

  1. Inicie IBM Cognos Upgrade Manager colocando el siguiente URI en su navegador web. Tenga en cuenta que 4797 es el puerto por omisión. http://localhost:4797/upgradeManager/3.0/index.html.
    si Upgrade Manager se encuentra instalado en un servidor remoto, reemplace “localhost” con la dirección IP o el nombre del servidor.
    Figura 2 La pantalla inicial Welcome de IBM Cognos Upgrade Manager
    Figura 2 La pantalla inicial Welcome de IBM Cognos Upgrade Manager
  2. Haga clic en el enlace New Project para crear un proyecto nuevo y darle un nombre. Por ejemplo, “Benchmarking Project”.
    Figura 3 La pantalla New Proyect de IBM Cognos Upgrade Manager
    Figura 3 La pantalla New Proyect de IBM Cognos Upgrade Manager
  3. Haga clic en Create y luego en Configure para comenzar a configurar el proyecto.
    Figura 4 La pantalla initial Configuration de IBM Cognos Upgrade Manager
    Figura 4 La pantalla initial Configuration de IBM Cognos Upgrade Manager
    Lo que debe recordar a esta altura es que IBM Cognos Upgrade Manager ha sido desarrollado para ayudar a los clientes a validar informes entre 2 versiones diferentes de productos de IBM Cognos. Lo que nosotros vamos a hacer es configurar nuestro proyecto para indicar el mismo entorno de IBM Cognos 8 y luego usar la funcionalidad de IBM Cognos Upgrade Managers para probar la instalación de IBM Cognos 8 en el mismo programa antes y después de una actualización de código de IBM Cognos 8. Esto significa que los URIs de transporte fuente y los destino serán los mismos.
  4. Use el mismo URI de transporte tanto para la fuente como para el destino, tal como se muestra más abajo.
    Figura 5 Pantalla Basic Configuration de IBM Cognos Upgrade Manager que muestra la fuente y el destino indicando la misma instancia de IBM Cognos 8
    Figura 5 Pantalla Basic Configuration de IBM Cognos Upgrade Manager que muestra la fuente y destino indicando la misma instancia de IBM Cognos 8
  5. Ahora diríjase a la etiqueta security. La configuración de la etiqueta security solicita la ID del espacio de nombre. Si usted no está seguro de la ID del espacio de nombre actual, puede obtenerla desde IBM Cognos Configuration en el servidor de IBM Cognos 8. Después de configurar la etiqueta Security, esta debería verse similar a la imagen que se encuentra a continuación.
    Figura 6 Configuración de la etiqueta Security de IBM Upgrade Manager que muestra Namespace_ID completo
    Figura 6 Configuración de la etiqueta Security de IBM Upgrade Manager que muestra Namespace_ID completo
    Ahora, si mira en el lado inferior de la esquina izquierda de the IBM Cognos Upgrade Manager UI verá estos 2 íconos y enlaces grisáceos.
    Figura 7 Ilustración que muestra la URL fuente y la URL destino en color gris y sin acceso
    Figura 7 Ilustración que muestra la URL fuente y la URL destino en color gris y sin acceso
    Estos íconos grisáceos le indican que IBM Cognos Upgrade Manager no se encuentra conectado a los sistemas fuente y destino.
  6. Para iniciar una conexión, en el cuadro de diálogo Configure haga clic en Save. Luego de hacer clic en save, los íconos deberían aparecer como disponibles.
  7. Ahora debemos traer nuestro contenido desde IBM Cognos Connection. Haga clic en el botón Generate Report List y se desplegarán sus paquetes y carpetas de IBM Cognos Connection.
  8. Usted puede seleccionar lo que desee validar antes y después de que el update/Fix Pack sea aplicado a su entorno.
    Figura 8 Pantalla de IBM Cognos Upgrade Manager que muestra los paquetes publicados en el portal IBM Cognos Connection
    Figura 8 Pantalla de IBM Cognos Upgrade Manager que muestra los paquetes publicados en el portal IBM Cognos Connection

    En este caso la opción “content” seleccionada importará todo desde la raíz hasta mi proyecto. Cuando la tarea haya sido completada su proyecto debería verse similar a este.

    Figura 9 Imagen de IBM Cognos Upgrade Manager de todo el contenido de IBM Cognos Connection importado al proyecto
    Figura 9 Imagen de IBM Cognos Upgrade Manager de todo el contenido de IBM Cognos Connection Content importado al proyecto

En el lado izquierdo encontramos una lista de “Upgrade Tasks”. Durante una actualización este es el orden lógico en el cual usted validaría la actualización de sus informes. Vamos a utilizar estas mismas tareas para validar nuestros informes después de aplicarlas y actualizar nuestro entorno de IBM Cognos 8. Como hemos analizado durante la fase de configuración, en lugar de tener 2 entornos de IBM Cognos 8, sólo tenemos uno. Trataremos las tareas “Source” como nuestro punto de partida para la comparación y las tareas “Target” como nuestro update/Fix Pack posterior.

Ejecución de la tarea del entorno fuente

En este ejemplo los informes que serán validados estarán en 2 carpetas, “Branch Information – Prompted” y “Misc Branch Reports – Non Prompted”. La validación de la fuente no es necesaria, los informes son válidos y actuales. Tenga en cuenta que la casilla de verificación que se encuentra al lado de estas carpetas es seleccionada para asegurar que todos los informes incluidos en las carpetas sean ejecutados. También tenga en cuenta que la lista desplegable a lado del botón Go ha sido colocada para ejecutar los informes.

Figura 10 IBM Cognos Upgrade Manager mostrando la carpeta seleccionada por medio de la opción Execute reports
Figura 10 IBM Cognos Upgrade Manager mostrando la carpeta seleccionada por medio de la opción Execute reports

Luego de presionar el botón Go, IBM Cognos Upgrade Manager envía la solicitud de ejecución en formato pdf de todos los informes de cada carpeta y la de traer nuevamente el contenido del pdf y guardarlo en el directorio C:\Program Files\cognos\UpgradeManager\data\projects\Benchmarking Project\. Usted puede validar esto en el directorio. Abra la carpeta de un informe que haya ejecutado y verá un directorio “SourceExecute” . Este será su archivo pdf.

Una vez que los informes sean ejecutados IBM Cognos Upgrade Manager mostrará una cerradura en ambas carpetas para evitar que se vuelvan a ejecutar accidentalmente.

Figura 11 Pantalla de IBM Cognos Upgrade Manager que muestra el ícono en forma de cerradura para las carpetas seleccionadas que contienen informes ya ejecutados
Figura 11 Pantalla de IBM Cognos Upgrade Manager que muestra el ícono en forma de cerradura para las carpetas seleccionadas que contienen informes ya ejecutados

Asegúrese de realizar el backup del directorio del proyecto para cerciorarse de haber guardado este resultado. El directorio del proyecto se encontrará en la ubicación de instalación de Upgrade Manager. Por ejemplo: C:\Program Files\cognos\UpgradeManager\data\projects

Validación y ejecución de las tareas del entorno destino

Una vez que IBM Cognos 8 o el software de la tercera parte ha sido actualizado y reiniciado usted puede iniciar IBM Cognos Upgrade Manager nuevamente y abrir su proyecto de comparación. Antes de ejecutar los informes, estos deben validarse. Esto asegurará que no haya errores antes de tratar de ejecutar los informes.

Ahora seleccione las mismas 2 carpetas, “Branch Information – Prompted” y “Misc Branch Reports – Non Prompted”, como lo hizo antes y haga lo mismo para las fases Target Validation y Target Execute.

Tenga presente mientras realiza estos pasos que el estado de la tarea sigue apareciendo como “New”. Esto indica que la tarea no ha sido completada aún.

Figura 12 Captura de pantalla de IBM Cognos Upgrade Manager de la pantalla de Target Validation
Figura 12 Captura de pantalla de IBM Cognos Upgrade Manager de la pantalla de Target Validation

Target Validation vuelve al estado “Completed”, lo cual indica que no han ocurrido errores en la validación. Usted puede proceder a la tarea Target Execution.

Después de completar Target Execute, el estado cambia a “Completed”.

Figura 13 IBM Cognos Upgrade Manager
Figura 13 IBM Cognos Upgrade Manager

Hemos completado los pasos necesarios para realizar la comparación y determinar si la actualización de software de IBM Cognos 8 o la actualización de software de la tercera parte ha afectado nuestros informes.

Comparación del resultado generado por Source y Target Executions

Una vez completas las tareas fuente y destino, el resultado del pdf se encuentra disponible para que IBM Cognos Upgrade Manager lo compare. Seleccione la tarea “Output Compare” y luego seleccione las casillas de verificación que se encuentran junto a las carpetas. Asegúrese de que la lista desplegable que se encuentra al lado del botón “Go” se encuentre en “Compare reports” y haga clic en el botón Go. Debería observar la siguiente pantalla.

Figura 14 Pantalla de IBM Cognos Upgrade Manager que muestra la barra de progreso de la comparación del PDF
Figura 14 Pantalla de IBM Cognos Upgrade Manager que muestra la barra de progreso de la comparación del PDF

Usted puede ahora analizar en profundidad la carpeta Branch Information – Prompted en IBM Cognos Upgrade Manager para ver el estado de cada informe en particular. En este caso se indica que no hay diferencias.

Figura 15 Resultados de la comparación de IBM Cognos Upgrade Manager que no presentan diferencias
Figura 15 Resultados de la comparación de IBM Cognos Upgrade Manager que no presentan diferencias

Ahora tiene la información necesaria para determinar si el actualizador de IBM Cognos 8 o Fix Pack o la actualización de software de la tercera parte no ha tenido efectos negativos en los datos de sus informes.

Visualización de las estadísticas de su proyecto de comparación

En cualquier momento usted puede ir a la tarea “Task Summary” y darle un buen vistazo al progreso del proyecto y ver en que fase del proceso se encuentra.

Figura 16 IBM Cognos Upgrade Manager mostrando una visión general gráfica de los resultados de la comparación
Figura 16 IBM Cognos Upgrade Manager mostrando una visión general gráfica de los resultados de la comparación

Esta vista se puede exportar a un archivo flash que luego puede distribuirse. El archivo flash es completamente interactivo y le brinda la posibilidad de ver las notas y el estado de cada uno de los informes en particular.


Recomendaciones adicionales

Se sugiere dar una verificación rápida a algunos informes para validar que la actualización de software no cree problemas de formato. Aunque IBM Cognos Upgrade Manager realiza un muy buen trabajo identificando problemas de datos y algunas cuestiones de formato, este no identificará todas las diferencias de formato.

Uso de la herramienta de comparación de Upgrade Manager

IBM Cognos Upgrade Manager tiene dos herramientas de comparación incorporadas y listas para ser utilizadas. En este ejemplo nos referiremos a las propiedades de un informe y usaremos Flash Compare Tool para asegurarnos de que el informe se vea exactamente igual antes y después de la actualización de software.

  1. En la tarea Output Compare analizamos en detalle la carpeta Branch Information – Prompted.
  2. Vaya a las propiedades de un informe que está debajo del título de la columna opciones. Haciendo clic en el ícono de propiedades nos dirigiremos a la siguiente página.
    Figura 17 IBM Cognos Upgrade Manager mostrando la etiqueta Status y una lista de herramientas de comparación de PDF disponibles
    Figura 17 IBM Cognos Upgrade Manager mostrando la etiqueta Status y una lista de herramientas de comparación de PDF disponibles
  3. Ahora podemos iniciar la herramienta haciendo clic en el enlace “Launch Flash Output Compare Tool” . Esto nos lleva a la herramienta y nos facilita varias opciones para validar que ese formato de informe no ha cambiado.
    Figura 18 Pantalla de comparación Flash de IBM Cognos Upgrade Manager que muestra dos informes PDF, uno al lado del otro
    Figura 18 Pantalla de comparación Flash de IBM Cognos Upgrade Manager que muestra dos informes PDF, uno al lado del otro

Los botones en la parte superior nos permiten realizar varias funciones que nos permitirán concentrarnos en el informe y asegurarnos de que no ha cambiado. Algunas de estas funciones son:

  • Side by side view: Superposición(esto coloca un pdf sobre el otro para permitirnos identificar los cambios).
  • Data compare: Usted puede desplazar, agrandar imágenes y establecer el foco de forma simultánea mientras utiliza la funcionalidad de superposición.

Comentarios

developerWorks: Ingrese

Los campos obligatorios están marcados con un asterisco (*).


¿Necesita un IBM ID?
¿Olvidó su IBM ID?


¿Olvidó su Password?
Cambie su Password

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


La primera vez que inicie sesión en developerWorks, se creará un perfil para usted. La información en su propio perfil (nombre, país/región y nombre de la empresa) se muestra al público y acompañará a cualquier contenido que publique, a menos que opte por la opción de ocultar el nombre de su empresa. Puede actualizar su cuenta de IBM en cualquier momento.

Toda la información enviada es segura.

Elija su nombre para mostrar



La primera vez que inicia sesión en developerWorks se crea un perfil para usted, teniendo que elegir un nombre para mostrar en el mismo. Este nombre acompañará el contenido que usted publique en developerWorks.

Por favor elija un nombre de 3 - 31 caracteres. Su nombre de usuario debe ser único en la comunidad developerWorks y debe ser distinto a su dirección de email por motivos de privacidad.

Los campos obligatorios están marcados con un asterisco (*).

(Por favor elija un nombre de 3 - 31 caracteres.)

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


Toda la información enviada es segura.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=90
Zone=Information mgmt
ArticleID=606781
ArticleTitle=Prácticas probadas de IBM Cognos : Comparación de su entorno IBM Cognos 8 por medio de IBM Cognos Upgrade Manager
publish-date=01062011