Configuración del tiempo de ejecución de JRC (Java Reporting Component) de Crystal Reports

Para utilizar ClearQuest Report Server for Crystal Reports para informes de ClearQuest, instale y configure una versión soportada del componente JRC (Java Reporting Component) de Crystal Reportes en WebSphere Application Server.

Antes de empezar

Si ha instalado el tiempo de ejecución de Java Reporting Component, elimine la versión existente antes de realizar estos pasos de configuración. Consulte Eliminación del tiempo de ejecución de JRC de Crystal Reports.

Acerca de esta tarea

Para obtener información acerca de las versiones soportadas de ClearQuest de las versiones del tiempo de ejecución JRC (Java Reporting Component) de Crystal Reports y dónde descargarlos, consulte la Nota técnica 1216371.

Estas instrucciones incluyen las referencias a esta variable:

%CLEARQUEST_HOME%\cqweb\cqwebprofile
En Windows, esta variable representa la vía de acceso predeterminada para el directorio de perfiles de WebSphere donde se despliegan las aplicaciones web de ClearQuest. CLEARQUEST_HOME es el directorio donde se ha instalado ClearQuest.
$CLEARQUEST_HOME/cqweb/cqwebprofile/
En Linux y UNIX, esta variable representa la vía de acceso predeterminada para el directorio de perfiles de WebSphere donde se despliegan las aplicaciones web de ClearQuest. CLEARQUEST_HOME es el directorio donde se ha instalado ClearQuest.
Nota: En estas instrucciones, el directorio de instalación para el tiempo de ejecución JRC, está basado en que ClearQuest se ha instalado en un perfil de WebSphere nuevo en esta ubicación predeterminada:
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
Si se ha instalado ClearQuest en un perfil de WebSphere Application existente, esta vía de acceso puede ser diferente, y la vía de acceso de las instrucciones se debe actualizar antes de copiar los archivos JRC. Otra ubicación común que se ha de comprobar es este directorio:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war.
Si ClearQuest se ha alojado en la plataforma Solaris, el directorio de la celda de WebSphere Application Server predeterminado es <srv>Node01Cell. El valor de dfltCell es el valor predeterminado para las plataformas Windows, Unix y Linux.

Procedimiento

  1. Descargue el archivo de archivado JRC (Java Reporting Component) de Crystal Reports que cumple con los requisitos de informes de ClearQuest. Consulte la Nota técnica 1216371.
  2. Copie el JRC de Crystal Reports en la aplicación web.
    En Windows
    Ejecute el archivo por lotes para copiar el JRC en la aplicación web.

    Si está utilizando el JRC de Crystal Reports versión 11.8.x, ejecute configureJRC.bat. Para JRC versión 12.2.x, ejecute configureJRC12.bat.

    1. Desde un indicador de mandatos, vaya al directorio donde se han instalado los archivos por lotes de ClearQuest:
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Copie el archivo de archivado del tiempo de ejecución de JRC de Crystal Reports en este directorio.
    3. Ejecute uno de los mandatos siguientes en función de la versión del tiempo de ejecución que esté desplegando.
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    En Unix
    Si utiliza Crystal Reports JRC, versión 11.8.x, ejecute el script del shell configureJRC.sh. Si está utilizando Crystal Reports JRC, versión 12.2.x, ejecute el script configureJRC12.sh.
    1. Abra una ventana de la consola UNIX y vaya al directorio donde se han instalado los scripts del shell de ClearQuest.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Copie el archivo de archivado del tiempo de ejecución de JRC de Crystal Reports en este directorio.
    3. Establezca el permiso para la versión del script que desea ejecutar:
      chmod u+x ./configureJRC.shchmod u+x ./configureJRC12.sh
    4. Ejecute el mandato para la versión de JRC que está copiando:
      ./configureJRC.sh JRC_runtime_file.zip
      ./configureJRC12.sh JRC_runtime_file.zip
  3. Detenga y reinicie IBM WebSphere Application Server para que se activen los cambios.
    Nota: El directorio de estas instrucciones puede ser diferente si ClearQuest se ha instalado en el perfil de WebSphere existente.
    En Windows:
    1. Pulse Inicio>Panel de control>Herramientas administrativas>Servicios.
    2. En el panel Servicios, pulse con el botón derecho de IBM WebSphere Application Server v7.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile.
    3. Pulse Detener.
    4. Cuando se detenga el servicio, pulse con el botón derecho del ratón en el nombre del servidor y pulse Inicio para reiniciar el servidor.
    En los sistemas UNIX y Linux:
    1. En una ventana de la consola UNIX, vaya al directorio bin del perfil de Websphere donde se han instalado los componentes del servidor ClearQuest.
      Nota: El directorio de estas instrucciones puede ser diferente si ClearQuest se ha instalado en el perfil de WebSphere existente.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. Ejecute estos mandatos para detener e iniciar el perfil predeterminado:
      ./stopServer.sh server1
      ./startServer.sh server1
  4. Para verificar que ClearQuest Report Server for Crystal Reports se ha configurado correctamente, abra una ventana de navegador y vaya a este URL: http://localhost:<puerto>/cqwebreport/CRInvoker Donde <puerto> es el puerto definido en el perfil para desplegar la aplicación. El perfil de ClearQuest predeterminado utiliza puerto 12080. El perfil predeterminado de WebSphere Application Server utiliza puerto 9080.
    Si el servidor se ha configurado correctamente, se muestra este mensaje.
    The report document has expired.
  5. Pasos de configuración adicionales que son necesarios en estas situaciones:
    • Hay un nombre de campo de la base de datos modificado en el esquema de ClearQuest.
    • Los nombres de los campos de visualización de ClearQuest no coinciden con los nombres de campo de la base de datos.
    • Los nombres de los campos de visualización de ClearQuest superan los 30 caracteres.
    Consulte la Nota técnica 1419660.

Comentarios