Configuration de l'exécution Crystal Reports Java Reporting Component (JRC)

Pour utiliser la génération de rapports ClearQuest Report Server for Crystal Reports for ClearQuest, installez et configurez une version prise en charge de Crystal Reports Java Reporting Component (JRC) sur WebSphere Application Server.

Avant de commencer

Si vous avez déjà installé l'exécution Java Reporting Component, supprimez la version existante avant d'exécuter ces étapes de configuration. Voir Suppression de l'exécution Crystal Reports JRC.

Pourquoi et quand exécuter cette tâche

Pour plus d'informations sur les versions prises en charge de ClearQuest des versions d'exécution de Crystal Reports Java Reporting Component (JRC) et sur l'emplacement de leur téléchargement, voir la note technique 1216371.

Ces instructions comprennent des références à cette variable :

%CLEARQUEST_HOME%\cqweb\cqwebprofile
Sous Windows, cette variable représente le chemin par défaut du répertoire de profil WebSphere sur lequel les applications Web ClearQuest sont déployées. CLEARQUEST_HOME est le répertoire sur lequel ClearQuest est installé.
$CLEARQUEST_HOME/cqweb/cqwebprofile/
Sous Linux et UNIX, cette variable représente le chemin par défaut du répertoire de profil WebSphere sur lequel les applications Web ClearQuest sont déployées. CLEARQUEST_HOME est le répertoire sur lequel ClearQuest est installé.
Remarque : Dans ces instructions, le répertoire d'installation de l'exécution JRC est basé sur le composant ClearQuest installé dans un nouveau profil WebSphere dans cet emplacement par défaut :
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
Si ClearQuest a été installé sur un profil WebSphere Application existant, ce chemin peut être différent et le chemin des instructions doit être mis à jour avant de copier les fichiers JRC. Un autre emplacement commun à contrôler est ce répertoire :
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war.
Si ClearQuest est hébergé sur la plateforme Solaris, le répertoire de cellule WebSphere Application Server par défaut est <srv>Node01Cell. La valeur dfltCell est la valeur par défaut pour les plateformes Windows, Unix et Linux.

Procédure

  1. Téléchargez le fichier d'archivage Crystal Reports Java Reporting Component (JRC) qui répond à vos exigences de génération de rapports ClearQuest. Voir la note technique 1216371.
  2. Copiez Crystal Reports JRC dans l'application Web.
    Sous Windows
    Exécutez le fichier de traitement par lots pour copier le composant JRC dans l'application Web.

    Si vous utilisez Crystal Reports JRC version 11.8.x, exécutez configureJRC.bat. Pour JRC version 12.2.x, exécutez configureJRC12.bat

    1. A partir d'une invite de commande, recherchez le répertoire dans lequel les fichiers de traitement par lots ClearQuest ont été installés :
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Copiez le fichier d'archivage de l'exécution Crystal Reports JRC dans ce répertoire.
    3. Exécutez l'une des commandes suivantes en fonction de la version de l'exécution que vous déployez.
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    Sous Unix :
    Si vous utilisez Crystal Reports JRC, version 11.8.x, exécutez le script de shell configureJRC.sh. Si vous utilisez Crystal Reports JRC, version 12.2.x, exécutez le script configureJRC12.sh.
    1. Ouvrez une fenêtre console UNIX et recherchez le répertoire dans lequel les scripts de shell ClearQuest ont été installés.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Copiez le fichier d'archivage de l'exécution Crystal Reports JRC dans ce répertoire.
    3. Définissez les droits de la version du script à exécuter :
      chmod u+x ./configureJRC.sh
      chmod u+x ./configureJRC12.sh
    4. Exécutez la commande de la version JRC que vous copiez :
      ./configureJRC.sh JRC_runtime_file.zip
      ./configureJRC12.sh JRC_runtime_file.zip
  3. Arrêtez et redémarrez IBM WebSphere Application Server pour activer les changements.
    Remarque : Le répertoire de ces instructions peut être différent si ClearQuest a été installé dans un profil WebSphere existant.
    Sous Windows :
    1. Cliquez sur Démarrer > Panneau de configuration > Administrative Tools > Services (Outils d'administration et services) .
    2. dans la sous-fenêtre Services, cliquez avec le bouton droit de la souris sur IBM WebSphere Application Server v7.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile.
    3. Cliquez sur Stop (Arrêter).
    4. Une fois le service arrêté, cliquez avec le bouton droit de la souris sur le nom de serveur et cliquez sur Démarrer pour redémarrer le serveur.
    Sur un système UNIX et sous Linux :
    1. A partir d'une fenêtre de console UNIX, recherchez le répertoire bin du profil WebSphere dans lequel les composants de serveur ClearQuest sont installés.
      Remarque : Le répertoire de ces instructions peut être différent si ClearQuest a été installé dans un profil WebSphere existant.
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. Exécutez ces commandes pour arrêter et démarrer le profil par défaut :
      ./stopServer.sh server1
      ./startServer.sh server1
  4. Pour vérifier que ClearQuest Report Server for Crystal Reports est correctement configuré, ouvrez une fenêtre de navigateur et recherchez cette adresse URL : http://localhost:<port>/cqwebreport/CRInvoker<port> est le port défini dans le profil pour déployer l'application. Le profil par défaut ClearQuest utilise le port 12080. Le profil par défaut WebSphere Application Server utilise le port 9080.
    Si le serveur est correctement configuré, ce message s'affiche.
    Le document de rapport est arrivé à expiration.
  5. Des étapes de configuration supplémentaires sont nécessaires dans ces situations.
    • Un nom de zone de base de données est modifié dans le schéma ClearQuest.
    • Les noms de zone d'affichage ClearQuest ne correspondent pas aux noms de zone de base de données.
    • Les noms de zone d'affichage ClearQuest font plus de 30 caractères.
    Voir la note technique 1419660.

Commentaires