Configuration de l'adaptateur Rational ClearQuest sur Apache Tomcat

Vous pouvez rendre les bibliothèques partagées de IBM® Rational ClearQuest accessibles à l'application IBM Rational Publishing Engine Data Services de sorte que l'API de Rational ClearQuest puisse être utilisée à partir de Rational Publishing Engine.

Avant de commencer

  • Rational ClearQuest doit être installé sur le même ordinateur que votre serveur d'applications.
  • Déployez l'application Reporting data services de Rational Publishing Engine et les adaptateurs Reporting Data Services.
  • Corrigez les problèmes liés aux avertissements de pare-feu ou aux licences avant de configurer les bibliothèques partagées de Rational ClearQuest.

Procédure

  1. Copiez les bibliothèques partagées Rational ClearQuest depuis les fichiers d'application Rational ClearQuest :

    fichiers_application\IBM\RationalSDLC\ClearQuest\cqjni.jar
    fichiers_application\IBM\RationalSDLC\ClearQuest\stpcq.jar
    fichiers_application\IBM\RationalSDLC\Common\stpcmmn.jar
    fichiers_application\IBM\RationalSDLC\Common\stpwvcm.jar

    Remarque : Les valeurs par défaut répertoriées concernent Rational ClearQuest 7.1. Les véritables chemins d'accès à utiliser dépendent de l'emplacement d'installation et de la version de Rational ClearQuest. Vérifiez que vous faites bien référence aux fichiers dans leurs emplacements appropriés. Pour déterminer l'emplacement de votre installation Rational ClearQuest, accédez à IBM Installation Manager en cliquant sur Démarrer > Tous les programmes > IBM Installation Manager > Afficher les packages installés.
  2. Collez les bibliothèques partagées de Rational ClearQuest dans le répertoire Apache Tomcat %CATALINA_HOME%\lib.
  3. Icône Linux Si vous utilisez Linux, configurez l'argument JVM générique :
    1. Ouvrez le fichier utilisé pour démarrer le serveur Apache Tomcat. Exemple : %CATALINA_HOME%/bin/startup.sh
    2. Ajoutez la commande suivante à la fin du fichier :
      export JAVA_OPTS="-Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib"
  4. Icône Linux Si vous utilisez Linux, configurez la variable d'environnement LD_LIBRARY_PATH :
    1. Dans le fichier utilisé pour démarrer le serveur Apache Tomcat, ajoutez la commande suivante à la fin du fichier :
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
    2. Sauvegardez les modifications dans le fichier utilisé pour démarrer le serveur Apache Tomcat.
  5. Redémarrez l'application Reporting data services.
  6. Vérifiez que l'adaptateur et les bibliothèques de IBM Rational ClearQuest sont correctement configurés. Entrez l'URL de l'adaptateur Rational ClearQuest dans un navigateur.
    • Entrez http://hôte:port/DataServices/ClearQuest. Si l'installation est correcte, vous pouvez voir une liste des connexions Rational ClearQuest telles qu'elles sont affichées dans l'outil de maintenance de Rational ClearQuest.
    • Entrez http://hôte:port/DataServices/ClearQuest/version. Si l'installation est correcte, vous pouvez voir une liste des bases de données d'utilisateurs de Rational ClearQuest.
    • Entrez http://hôte:port/DataServices/ClearQuest/version/nom_base_de_données. Si l'installation est correcte, vous pouvez voir une liste des requêtes.

Que faire ensuite

Copiez une URL de requête à ajouter à un canevas ou une spécification de document.
Remarque : L'application Reporting data services ne prend en charge que les requêtes possédant des ensembles de résultats statiques. Les requêtes dynamiques ne sont pas prises en charge.

Exemple

Avec l'URL de la requête All Defects, vous pouvez voir un ensemble de résultats avec le nombre d'occurrences que la requête doit renvoyer pour le client Rational ClearQuest. Chaque résultat est un ID de base de données (DBID) unique pour un type d'enregistrement particulier. Vous pouvez poursuivre ce processus jusqu'à ce que vous obteniez un retour pour les données d'un enregistrement spécifique. Conservez l'URL de la requête pour l'utiliser dans la création de rapports Rational Publishing Engine.

Supprimez les arguments à partir du point d'interrogation compris :

Avant : http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
Après : http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


Retour d'informations