Configurer Rational Asset Manager pour l'intégration avec Rational ClearQuest

Intégrez IBM® Rational Asset Manager avec IBM Rational ClearQuest et configurez des connexions entre les deux produits.

Pourquoi et quand exécuter cette tâche

Pour intégrer Rational Asset Manager avec Rational ClearQuest, installez le client Rational ClearQuest sur le même ordinateur que le serveur Rational Asset Manager. Pour connecter Rational Asset Manager à l'emplacement serveur Rational ClearQuest approprié, l'administrateur doit connaître l'URL du client Web Rational ClearQuest.

L'image suivante illustre les connexions nécessaires à la configuration de Rational ClearQuest.

Une fois Rational ClearQuest installé, insérez les bibliothèques dynamiques dans le chemin sur le serveur Web :
  • Windows
    1. Cliquez avec le bouton droit sur Poste de travail et cliquez sur Propriétés.
    2. Dans la page Avancé, cliquez sur Variables d'environnement.
    3. Dans la section Variables système, sélectionnez la variable Path et cliquez sur Modifier.
    4. Tapez le répertoire d'installation de Rational ClearQuest à la fin de la chaîne du chemin. Séparez le répertoire et le chemin par un point-virgule. Par exemple, ;C:\Rational\ClearQuest.
    5. Enregistrez vos modifications.
  • Linux et UNIX
    1. Définissez les variables d'environnement suivantes :
      • Dans le shell Bourne (sh)
        export TZ=[fuseau_horaire_local] (par exemple, EST5EDT)
        export LD_ASSUME_KERNEL=2.4.19
        export LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib
      • Dans le shell C (csh)
        setenv TZ=[fuseau_horaire_local] (par exemple, EST5EDT)
        setenv LD_ASSUME_KERNEL=2.4.19
        setenv LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib
    2. Sourcez le fichier cq_setup.sh :
      • Pour csh, tcsh et les autres shells compatibles csh :
        source cquest-home-dir/cq_setup.csh
      • Pour sh, ksh, bash et les autres shells compatibles Bourne :
        . cquest-home-dir/cq_setup.sh
Faites en sorte que le fichier cqini.jar de Rational ClearQuest soit chargé par le chargeur de classes de base du serveur Web :
  • IBM WebSphere Application Server
    Pour lier l'application Web à une bibliothèque partagée contenant le fichier cqJni.jar :
    1. Copiez le fichier linkscript.py à partir du répertoire <rép_install_RAM>\ram\conf\cq dans le dossier \bin de votre répertoire d'installation WebSphere Application Server.
    2. Ouvrez une invite de commande et placez-vous dans le dossier \bin.
    3. Exécutez la commande suivante :
      wsadmin -f linkscript.py -lang jython -conntype SOAP -user nom_util
      -password mot_passe -rInstallPath rép_rational -appName nom_application
      -machine nom_machine -node nom_noeud -cell nom_cellule -process nom_processus
      -library nom_bibliothèque -force
      où :
      • nom_util et mot-passe sont vos nom d'utilisateur et mot de passe d'administration de WebSphere Application Server.
      • rép_rational est le répertoire racine où les applications Rational sont installées. Par exemple, C:/Rational. Utilisez la barre oblique (/) comme séparateur de chemins, même sous Windows. Si Rational ClearQuest est installé dans C:/Rational/ClearQuest, tapez C:/Rational pour la valeur rép_rational.
        Remarque : Sous Windows, utilisez la version courte des noms de dossier. Par exemple, si le répertoire racine d'installation des applications Rational est C:/Program Files/Rational/ClearQuest, tapez C:/Progra~1/Rational/ClearQuest pour la valeur rép_rational.
      • nom_application est le nom affiché pour votre application Rational Asset Manager. Si vous avez utilisé Installation Manager pour installer Rational Asset Manager, ce nom est RAM1WebApplication. Si vous avez installé l'application Web dans votre propre installation de WebSphere Application Server, le nom affiché est celui que vous avez fourni lors de l'installation. La valeur par défaut est RAM1WebApplication.
      • nom_processus est optionnel. Fournissez-le si vous devez spécifier le processus auquel vous vous connectez. La valeur par défaut est server1.
      • nom_machine, nom_noeud et nom_cellule sont optionnels. Fournissez-les si vous devez spécifier le chemin du serveur sous lequel votre application Web Rational Asset Manager est installée. Par exemple, Cell:machineNodeCell. Fournissez les trois. Par défaut, ils sont déterminés automatiquement d'après le nom du processus.
      • nom_bibliothèque est optionnel. Fournissez-le pour forcer le script à utiliser une bibliothèque partagée existante ou pour créer une bibliothèque partagée de ce nom. Le nom de bibliothèque par défaut est CQLib
      • force est optionnel. Spécifiez-le pour créer une nouvelle bibliothèque partagée, même s'il en existe déjà une.
  • Tomcat

    Pour ajouter le fichier cqJni.jar au chargeur de classes de base de Tomcat, suivez l'une des procédures ci-dessous :

    • Copier le fichier cqJni.jar depuis le répertoire d'installation de Rational ClearQuest vers le dossier \common\lib du répertoire d'installation de Tomcat.
      Remarque : Si vous passez à une nouvelle version de Rational ClearQuest, vous devez répéter cette étape afin de copier le nouveau fichier cqini.jar.
    • Pour éviter de copier le fichier, modifier le script de démarrage catalina.bat afin d'inclure le fichier cqJni.jar dans le chemin de classes de Tomcat :
      1. Naviguez jusqu'au dossier \bin du répertoire d'installation de Tomcat.
      2. Dans un éditeur de texte, ouvrez le fichier catalina.bat.
      3. Dans le fichier, recherchez la ligne qui ressemble à ceci :
        set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar
      4. Ajoutez le code suivant à la fin de cette ligne :
        ;rép_ClearQuest\cqJni.jar
        où ClearQuest-dir représente le chemin d'accès complet à l'installation de Rational ClearQuest.
      5. Enregistrez et fermez le fichier.

Commentaires