Configurando o tempo de execução do Crystal Reports Java Reporting Component (JRC)

Para usar o ClearQuest Report Server for Crystal Reports para relatório do ClearQuest, instale e configure uma versão suportada do Crystal Reports Java Reporting Component (JRC) no WebSphere Application Server.

Antes de Iniciar

Se você já tiver instalado o tempo de execução do Java Reporting Component, remova a versão existente antes de executar essas etapas de configuração. Consulte Removendo o tempo de execução do Crystal Reports JRC.

Sobre Esta Tarefa

Para obter informações sobre as versões suportadas pelo ClearQuest das versões do tempo de execução do Crystal Reports Java Reporting Component (JRC) e onde fazer download delas, consulte a Nota técnica 1216371.

Estas instruções incluem referências para esta variável:

%CLEARQUEST_HOME%\cqweb\cqwebprofile
No Windows, essa variável representa o caminho padrão para o diretório de perfil do WebSphere no qual os aplicativos da web do ClearQuest estão implementados. CLEARQUEST_HOME é o diretório no qual o ClearQuest é instalado.
$CLEARQUEST_HOME/cqweb/cqwebprofile/
No Linux e UNIX, essa variável representa o caminho padrão para o diretório de perfil do WebSphere no qual os aplicativos da web do ClearQuest são implementados. CLEARQUEST_HOME é o diretório no qual o ClearQuest é instalado.
Nota: Nestas instruções, o diretório de instalação para o tempo de execução JRC é baseado no ClearQuest que está sendo instalado em um novo perfil do WebSphere neste local padrão:
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
Se o ClearQuest foi instalado em um perfil do aplicativo WebSphere existente, esse caminho pode ser diferente, e o caminho nas instruções deve ser atualizado antes de copiar os arquivos JRC. Outro local comum para verificar é este diretório:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war.
Se o ClearQuest estiver hospedado na plataforma Solaris, o diretório da célula padrão do WebSphere Application Server será <srv>Node01Cell. O valor dfltCell é o padrão para as plataformas Windows, Unix e Linux.

Procedimento

  1. Faça download do archive do Crystal Reports Java Reporting Component (JRC) que atenda aos requisitos de relatório do ClearQuest. Consulte a Nota Técnica 1216371.
  2. Copie o Crystal Reports JRC no aplicativo da web.
    No Windows
    Execute o arquivo em lote para copiar o JRC no aplicativo da web.

    Se você estiver usando o Crystal Reports JRC versão 11.8.x, execute o configureJRC.bat. Para JRC versão 12.2.x, execute configureJRC12.bat

    1. Em um prompt de comandos, acesse o diretório no qual os arquivos em lote do ClearQuest foram instalados:
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Copie o archive do tempo de execução do Crystal Reports JRC nesse diretório.
    3. Execute um dos comandos a seguir dependendo de qual versão do tempo de execução você está implementando.
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    No Unix
    Se você estiver usando o Crystal Reports JRC, versão 11.8.x, execute o shell script configureJRC.sh. Se você estiver usando o Crystal Reports JRC, versão 12.2.x, execute o script configureJRC12.sh.
    1. Abra uma janela do console do UNIX e acesse o diretório no qual os shell scripts do ClearQuest foram instalados.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Copie o archive do tempo de execução do Crystal Reports JRC nesse diretório.
    3. Configure a permissão para a versão do script que você deseja executar:
      chmod u+x ./configureJRC.sh
      chmod u+x ./configureJRC12.sh
    4. Execute o comando para a versão do JRC que você está copiando:
      ./configureJRC.sh JRC_runtime_file.zip
      ./configureJRC12.sh JRC_runtime_file.zip
  3. Pare e reinicie o IBM WebSphere Application Server para ativar as mudanças.
    Nota: O diretório nestas instruções poderá ser diferente, se o ClearQuest foi instalado em um perfil do WebSphere existente.
    Em Windows:
    1. Clique em Iniciar > Painel de Controle > Ferramentas Administrativas > Serviços.
    2. No painel Serviços, clique com o botão direito em IBM WebSphere Application Server v7.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile.
    3. Clique em Parar.
    4. Depois que o serviço for interrompido, clique com o botão direito no nome do servidor e clique em Iniciar para reiniciar o servidor.
    No sistema UNIX e Linux:
    1. Em uma janela do console do UNIX, acesse o diretório bin do perfil do WebSphere no qual os componentes do servidor ClearQuest são instalados.
      Nota: O diretório nestas instruções poderá ser diferente, se o ClearQuest foi instalado em um perfil do WebSphere existente.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. Execute estes comandos para parar e iniciar o perfil padrão:
      ./stopServer.sh server1
      ./startServer.sh server1
  4. Para verificar se o ClearQuest Report Server for Crystal Reports está configurado corretamente, abra uma janela do navegador e acesse esta URL: http://localhost:<port>/cqwebreport/CRInvoker em que <port> é a porta definida no perfil para implementar o aplicativo. O perfil do ClearQuest padrão usa port 12080. O perfil padrão do WebSphere Application Server usa port 9080.
    Se o servidor estiver configurado corretamente, esta mensagem será exibida.
    The report document has expired.
  5. Etapas de configuração adicionais são necessárias nestas situações:
    • Um nome de campo do banco de dados foi alterado no esquema do ClearQuest.
    • Os nomes de campo de exibição do ClearQuest não correspondem aos nomes de campo do banco de dados.
    • Os nomes de campo de exibição do ClearQuest excedem 30 caracteres.
    Consulte a Nota técnica 1419660.

Feedback