Configurazione del runtime di JRC (Java Reporting Component) per Crystal Reports

Per utilizzare il server report ClearQuest per Crystal Reports per la creazione di report ClearQuest, installare e configurare una versione supportata di JRC (Java Reporting Component) per Crystal Reports in WebSphere Application Server.

Prima di iniziare

Se il runtime JRC (Java Reporting Component) è già stato installato, rimuovere la versione esistente prima di eseguire queste operazioni di configurazione. Consultare Rimozione del runtime JRC per Crystal Reports.

Informazioni su questa attività

Per informazioni sulle versioni supportate da ClearQuest del runtime JRC (Java Reporting Component) per Crystal Reports e su dove scaricarle, consultare la nota tecnica 1216371.

Queste istruzioni includono riferimenti a questa variabile:

%CLEARQUEST_HOME%\cqweb\cqwebprofile
Su Windows, questa variabile rappresenta il percorso predefinito per la directory del profilo WebSphere in cui sono distribuite le applicazioni web ClearQuest. CLEARQUEST_HOME è la directory in cui è installato ClearQuest.
$CLEARQUEST_HOME/cqweb/cqwebprofile/
Su Linux e UNIX, questa variabile rappresenta il percorso predefinito della directory del profilo WebSphere in cui sono distribuite le applicazioni web ClearQuest. CLEARQUEST_HOME è la directory in cui è installato ClearQuest.
Nota: In queste istruzioni, la directory di installazione per il runtime JRC è basata su un'installazione di ClearQuest in un nuovo profilo WebSphere in questa posizione predefinita:
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
Se ClearQuest è stato installato in un profilo di WebSphere Application predefinito, questo percorso potrebbe essere differente ed è necessario aggiornare il percorso nelle istruzioni prima di copiare i file JRC. Un'altra posizione comune da verificare è la seguente directory:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war.
Se ClearQuest è ospitato sulla piattaforma Solaris, la directory della cella predefinita di WebSphere Application Server è <srv>Node01Cell. Il valore dfltCell è l'impostazione predefinita per le piattaforme Windows, Unix e Linux.

Procedura

  1. Scaricare il file dell'archivio di JRC (Java Reporting Component) per Crystal Reports che soddisfa i propri requisiti per la creazione di report ClearQuest. Consultare la nota tecnica 1216371.
  2. Copiare il JRC per Crystal Reports nell'applicazione web.
    Su Windows
    Eseguire il file batch per copiare il JRC nell'applicazione web.

    Se si sta utilizzando la versione 11.8.x del JRC per Crystal Reports, eseguire configureJRC.bat. Per la versione 12.2.x di JRC, eseguire configureJRC12.bat

    1. Da un prompt dei comandi, passare alla directory in cui sono stati installati i file batch di ClearQuest:
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Copiare il file di archivio del JRC per Crystal Reports in questa directory.
    3. Eseguire uno dei seguenti comandi, in base alla versione del runtime che si desidera distribuire.
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    Su Unix
    Se si sta utilizzando JRC per Crystal Reports versione 11.8.x, eseguire lo script shell configureJRC.sh. Se si sta utilizzando JRC per Crystal Reports versione 12.2.x, eseguire lo script configureJRC12.sh.
    1. Aprire una finestra di console UNIX e passare alla directory in cui sono stati installati gli script shell di ClearQuest.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Copiare il file di archivio del JRC per Crystal Reports in questa directory.
    3. Impostare l'autorizzazione per la versione dello script che si desidera eseguire:
      chmod u+x ./configureJRC.sh
      chmod u+x ./configureJRC12.sh
    4. Eseguire il comando per la versione di JRC che si sta copiando:
      ./configureJRC.sh JRC_runtime_file.zip
      ./configureJRC12.sh JRC_runtime_file.zip
  3. Arrestare e riavviare IBM WebSphere Application Server per attivare le modifiche.
    Nota: La directory in queste istruzioni potrebbe essere differente se ClearQuest è stato installato in un profilo WebSphere esistente.
    Su Windows:
    1. Fare clic su Start>Pannello di controllo>Strumenti di amministrazione>Servizi.
    2. Nel pannello Servizi, fare clic con il tasto destro del mouse su IBM WebSphere Application Server v7.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile.
    3. Fare clic su Arresta.
    4. Una volta arrestato il servizio, fare clic con il tasto destro del mouse sul nome del server e fare clic su Avvia per riavviare il server.
    Su sistema UNIX e Linux:
    1. Da una finestra di console UNIX, passare alla directory bin del profilo WebSphere in cui sono installati i componenti server ClearQuest.
      Nota: La directory in queste istruzioni potrebbe essere differente se ClearQuest è stato installato in un profilo WebSphere esistente.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. Eseguire questi comandi per arrestare ed avviare il profilo predefinito:
      ./stopServer.sh server1
      ./startServer.sh server1
  4. Per verificare che il server report ClearQuest per Crystal Reports sia configurato correttamente, aprire una finestra del browser e immettere il seguente URL: http://localhost:<port>/cqwebreport/CRInvoker Dove <port> è la porta definita nel profilo per distribuire l'applicazione. Il profilo predefinito di ClearQuest utilizza la porta 12080. Il profilo predefinito di WebSphere Application Server utilizza la porta 9080.
    Se il server è stato configurato correttamente, viene visualizzato questo messaggio.
    Il documento report è scaduto.
  5. In queste situazioni, sono necessarie ulteriori operazioni di configurazione:
    • Il nome di un campo del database è stato modificato nello schema ClearQuest.
    • I nomi dei campi di visualizzazione ClearQuest non corrispondono ai nomi dei campi del database.
    • I nomi dei campi di visualizzazione ClearQuest superano i 30 caratteri.
    Consultare la nota tecnica 1419660.

Feedback