Enregistrement des applications comme fournisseurs TRS pour les moteurs LQE (Lifecycle Query Engine)

Si vous utilisez Rational Engineering Lifecycle Manager, des étapes de configuration supplémentaires sont requises pour configurer les produits en tant que fournisseurs TRS et pour permettre à Lifecycle Query Engine d'accéder à leurs données. Si vous n'utilisez pas Rational Engineering Lifecycle Manager, il n'est pas nécessaire de suivre les étapes de cette section.

Une fois que vous avez installé et configuré toutes les applications et que vous avez créé des relations d'ami entre les applications sur les serveurs distants, vous devez définir chaque application en tant que fournisseur TRS (Tracked Resource Set) pour que Lifecycle Query Engine puisse accéder à leurs données lors de la création de l'index.

Etapes requises :

Affectez la licence TRS Consumer-Internal.

Affectez la licence TRS Consumer-Internal aux utilisateurs fonctionnels lqe_user et jts_user.

  1. Ouvrez la console d'administration de JTS dont l'adresse est https://nom_hôte:port/jts/admin.
  2. Sélectionnez Utilisateurs > Utilisateurs actifs.
  3. Cliquez sur le lien lqe_user. Dans la page lqe_user, accédez à la section Licence Client Access, sélectionnez TRS Consumer-Internal et cliquez sur Sauvegarder.
    Sélection de la licence TRS Consumer Internal pour l'utilisateur LQE principal
  4. Revenez dans la page des utilisateurs actifs. Cliquez sur le lien jts_user. Dans la page jts_user, accédez à la section Licence Client Access et sélectionnez TRS Consumer-Internal.
  5. Cliquez sur Sauvegarder.

Configuration de TRS pour les applications CLM

Si ces applications sont déployées sur le même serveur Jazz Team Server que LQE, il n'est pas nécessaire de créer des consommateurs entrants. Ces étapes ne doivent être effectuées que si les applications CCM, QM et RM se trouvent sur un serveur Jazz Team Server distinct.

  1. Créez le clé de consommateur entrant LQE pour CCM. Ouvrez la page d'administration CCM : https://nom_hôte:port/ccm/admin.
  2. Ouvrez la page Application, sélectionnez Communication >Consommateurs (entrants) et créez une nouvelle clé de consommateur OAuth pour LQE :
    • Nom : LQE
    • Valeur confidentielle : xyz
    • Digne de confiance : yes
    Cliquez sur Enregistrer.
  3. Accédez à la liste des clés autorisées et modifiez l'entrée LQE en cliquant sur l'icône de crayon.
  4. Dans la boîte de dialogue Edition des propriétés de la clé du consommateur, cliquez sur le lien Sélectionner des utilisateurs....
  5. Entrez lqe dans la zone de filtre et sélectionnez lqe_user dans la liste des utilisateurs correspondants. Cliquez sur Ajouter et fermer, puis sur Terminer.
  6. Créez la clé de consommateur entrant LQE pour QM. Ouvrez la page d'administration QM https://nom_hôte:port/qm/admin, puis effectuez les étapes 7 à 10 à nouveau.
  7. Créez la clé de consommateur entrant LQE pour DOORS Next Generation s'il s'agit de votre application RM. Ouvrez la page d'administration RM https://nom_hôte:port/rm/admin, puis effectuez les étapes 7 à 10 à nouveau.
  8. Enregistrez les applications en tant que fournisseurs TRS et générez leur index. Ouvrez la page d'administration de Lifecycle Query Engine : https://nom_hôte:port/lqe/web.
  9. Cliquez sur Administration > Sources de données > Ajouter une source de données.
  10. Dans la boîte de dialogue Ajouter une source de données, sélectionnez https://nom_hôte:port/ccm/oslc/workitem/trs et ajoutez le libellé RTC. Acceptez les valeurs par défaut restantes (si vous devez indexer un volume important de données, faites passer le nombre d'unités d'exécution à 4 pour la première indexation) et cliquez sur Terminer.
  11. Enregistrez QM comme fournisseur TRS et générez son index. Dans la page Sources de données, cliquez sur Ajouter une source de données.
  12. Dans la boîte de dialogue Ajouter une source de données, sélectionnez https://nom_hôte:port/qm/trs et ajoutez le libellé RQM. Acceptez les valeurs par défaut restantes et cliquez sur Terminer.
  13. Enregistrez RM comme fournisseur TRS et générez son index. Dans la page Sources de données, cliquez sur Ajouter une source de données.
  14. Dans la boîte de dialogue Ajouter une source de données, sélectionnez https://nom_hôte:port/rm/trs et ajoutez le libellé DNG. Acceptez les valeurs par défaut restantes et cliquez sur Terminer.

Vos applications Rational Team Concert, Rational Quality Manager et Rational DOORS Next Generation sont à présent indexées et accessibles depuis Rational Engineering Lifecycle Manager. Consultez la documentation de LQE (Lifecycle Query Engine) pour plus d'informations sur les préférences d'indexation permanente : Indexation de vos données avec le moteur LQE (Lifecycle Query Engine).

Configuration de DOORS et DOORS Web Access comme fournisseurs TRS

Rational DOORS et Derby sont fournis avec des utilisateurs et des mots de passe par défaut pour l'intégration TRS. Vous devez modifier les paramètres de configuration associés à ces utilisateurs, comme indiqué dans la procédure ci-dessous. L'intégration utilise les utilisateurs suivants :
  • Utilisateur fonctionnel LQE. Cet utilisateur gère les demandes LQE d'une application consommatrice TRS intégrée à Rational DOORS Web Access. Cet utilisateur doit exister dans la base de données Rational DOORS. Vous devez définir des paramètres pour cet utilisateur dans le fichier festival.xml.
  • trs.db.user. Il s'agit d'un utilisateur de base de données Derby qui a accès aux données de base de données TRS. Rational DOORS Web Access l'utilise pour extraire des données de la base de données. Vous devez définir un mot de passe pour cet utilisateur dans le fichier festival.xml et le fichier des propriétés Derby.
  • derby.user.admin. Il s'agit de l'administrateur de la base de données Derby. Actuellement, cet utilisateur ne fournit pas de fonctions pour la base de données Rational DOORS Web Access ou Derby. Vous pouvez définir un mot de passe pour cet utilisateur dans le fichier des propriétés Derby.
  1. Ouvrez le fichier [chemin_DWA]\server\festival\config\festival.xml.
    1. Recherchez la section Configurable system properties.
    2. Sous la propriété oauth.domain, ajoutez les propriétés répertoriées dans le tableau ci-dessous, en remplaçant votre ID et votre mot de passe administrateur DOORS et en sélectionnant un clé de consommateur et une valeur confidentielle. Ces propriétés doivent avoir le format suivant :
      <f:nom propriété="functional.user.consumer.key" value="clé_consommateur" />
    Tableau 1. Propriétés du fichier Festival.xml pour TRS et LQE
    Propriété Description/Valeur
    ForceHttpsForAuthenticationForOAuth Définissez la valeur true.
    oauth.domain Définissez la valeur https://serveur:port/dwa, où serveur est le nom de domaine ou l'adresse IP du serveur.
    functional.user.consumer.key Clé de consommateur associée à l'utilisateur fonctionnel LQE. Cette valeur est utilisée par Lifecycle Query Engine pour accéder au TRS (Tracked Resource Set) DOORS. Elle doit se trouver dans l'onglet des clés locales de la configuration Rational DOORS. La valeur par défaut est la clé de l'utilisateur fonctionnel LQE.
    functional.user.consumer.secret Valeur confidentielle associée à l'utilisateur fonctionnel LQE. Cette valeur est utilisée par Lifecycle Query Engine pour accéder au TRS (Tracked Resource Set) DOORS. Cette valeur confidentielle doit se trouver dans l'onglet des clés locales de la configuration Rational DOORS. La valeur par défaut est qwert6.
    functional.user.name Nom de l'utilisateur fonctionnel LQE. Ce nom d'utilisateur doit être un utilisateur valide Rational DOORS. La valeur par défaut est l'utilisateur fonctionnel LQE.
    functional.user.password Mot de passe de l'utilisateur fonctionnel LQE. La valeur par défaut est qwert6.
    trs.db.user Nom d'utilisateur de l'intégration TRS. Pour simplifier, utilisez le nom d'utilisateur par défaut trs.db.user.
    trs.db.password Mot de passe de trs.db.user. Vous devez également définir ce mot de passe dans le fichier des propriétés Derby.
    trs.page.size Nombre de ressources TRS à inclure dans une page. La valeur par défaut est 250.
    trs.enable Définissez la valeur true.
  2. Ouvrez le fichier derby.properties dans un éditeur. Ce fichier se trouve dans le répertoire install_DWA/derby.
  3. Remplacez les valeurs de mot de passe des paramètres dans le tableau suivant.
    Tableau 2. Paramètres du fichier de propriétés du serveur TRS
    Paramètre Description
    derby.user.trs Mot de passe de trs.db.user que vous avez défini dans le fichier festival.xml. La valeur par défaut est dwaTrsPa11word.
    derby.user.admin Mot de passe de l'administrateur de la base de données Derby. Actuellement, cet utilisateur ne fournit pas de fonctions pour la base de données Rational DOORS Web Access ou Derby. La valeur par défaut est dwaTrsPa11word.
  4. Exécutez le fichier de commandes install_DWA/derby.start.bat.
  5. Exécutez le fichier de commandes install_DWA/derby/scripts/init_trs.bat.
  6. Activez les paramètres DCN (Data Change Notifications) pour configurer le serveur de base de données Rational DOORS pour qu'il communique avec le courtier Rational DOORS Web Access et le serveur Rational DOORS Web Access. Pour plus d'informations, voir la rubrique http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html
  7. Redémarrez les serveurs DOORS Web Access dans l'ordre suivant :
    1. Courtier
    2. Interop
    3. Serveur de base de données
    4. Serveur d'applications Web
  8. Connectez-vous à Rational DOORS en utilisant les données d'identification suivantes :
    • Nom d'utilisateur : utilisateur fonctionnel LQE ou nom fonctionnel que vous avez défini dans le fichier festival.xml.
    • Mot de passe : qwert6 ou mot de passe du nom fonctionnel que vous avez défini dans le fichier festival.xml.
  9. Dans le menu Fichier, sélectionnez les clés locales OSLC et cliquez sur Ajouter.
    • Nom : LQE
    • Clé : xyz
    • Valeur confidentielle : xyz
    Cliquez sur Enregistrer, puis sur OK.
  10. Dans le menu Fichier, sélectionnez les jeux de documents OSLC.
  11. Dans le panneau de sélection de projet, recherchez le dossier Exigences, puis sélectionnez tous les modules qui se trouvent dans ce dossier dans le panneau de sélection de modules. Cliquez sur Appliquer.

Configuration de LQE pour utiliser DOORS Web Access comme source de données

  1. Accédez à https://nomhôte:port/lqe/web.
  2. Sélectionnez Administration dans le menu de barre d'outils.
  3. Dans la page des sources de données, sélectionnez Ajouter une source de données
  4. Dans la boîte de dialogue Ajouter une source de données, sélectionnez l'option d'URL de document des services racine, entrez l'URL des services racine DOORS, sélectionnez l'URL TRS, entrez un libellé et sélectionnez Spécifier les détails d'authentification.
    • URL des services racine : https://serveurdoors:port/dwa/public/rootservices
    • Sélectionnez https://serverdoors:port/dwa/rm/trs .
    • Libellé : DOORS
    Capture d'écran des valeurs Source de données de DOORS à ajouter au moteur LQE
  5. Entrez la clé de consommateur et la valeur confidentielle.
    Remarque : Ces valeurs doivent correspondre à celles qui figurent dans le fichier DOORS Web Access Festival.XML.
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    Capture d'écran de la clé de consommateur et de la valeur confidentielle
  6. Définissez 1 pour le nombre d'unités d'exécution pour l'indexation initiale et incrémentielle et cliquez sur Terminer. Des erreurs peuvent se produire si plusieurs unités d'exécution sont utilisées pour l'indexation.

Configuration de TRS pour l'application Rhapsody Design Manager

  1. Accédez à https://nomhôte:port/jts/admin.
    Remarque : Les consommateurs entrants de Design Manager sont définis dans la console d'administration de Jazz Team Server, et non dans la console Design Manager.
  2. Sélectionnez Serveur > Consommateurs (entrants), entrez les informations suivantes et cliquez sur Enregistrer :
    • Nom : LQE
    • Valeur confidentielle : xyz
    • Digne de confiance : yes
  3. Accédez à la liste des clés autorisées et modifiez l'entrée LQE en cliquant sur l'icône de crayon.
  4. Dans la boîte de dialogue Edition des propriétés de la clé du consommateur, cliquez sur le lien Sélectionner des utilisateurs....
  5. Entrez lqe dans la zone de filtre et sélectionnez lqe_user dans la liste des utilisateurs correspondants. Cliquez sur Ajouter et fermer, puis sur Terminer.
  6. Accédez à https://nomhôte:port/dm/web.
  7. Connectez-vous comme administrateur.
  8. Sélectionnez la zone de projet et Gérer les propriétés de projet dans le menu déroulant Administration (icône d'engrenage). Sélectionnez Contexte OSLC par défaut, puis cliquez sur Sélectionner, le nom du projet, OK et Enregistrer.
    Sélectionnez votre zone de projet et vérifiez que le contexte OSLC par défaut est affecté.
  9. Enregistrez Rhapsody DM comme fournisseur TRS et générez son index. Ouvrez la page d'administration de Lifecycle Query Engine : https://nom_hôte_lqe:port/lqe/web.
  10. Cliquez sur Administration > Sources de données > Ajouter une source de données.
  11. Dans la boîte de dialogue Ajouter une source de données, sélectionnez http://nom-hôte-rdm:9443/dm/trs et ajoutez le libellé RDM. Acceptez les valeurs par défaut restantes (si vous devez indexer un volume important de données, faites passer le nombre d'unités d'exécution à 4 pour la première indexation) et cliquez sur Terminer.

Configuration de TRS pour l'application Rational Engineering Lifecycle Manager

S'il s'agit d'une nouvelle installation, vous n'avez aucune donnée à indexer. Vous pouvez créer un projet exemple et de produit afin de vérifier que l'index est créé.

  1. Ouvrez la page d'administration de Lifecycle Query Engine : https://nom_hôte_lqe:port/lqe/web.
  2. Cliquez sur Administration > Sources de données > Ajouter une source de données.
  3. Dans la boîte de dialogue Ajouter une source de données, sélectionnez http://nom_hôte_relm:port/productdef/resource/tracked_resource_set et ajoutez RELM. Acceptez les valeurs par défaut restantes (si vous devez indexer un volume important de données, faites passer le nombre d'unités d'exécution à 4 pour la première indexation) et cliquez sur Terminer.
    Liste des sources de données contenant tous les composants indexés.
  4. Pour tester l'index, ouvrez Rational Engineering Lifecycle Manager : https://nom_hôte_relm:port/relm/web.
  5. Sélectionnez un exemple de projet. Dans le menu Requêtes, sélectionnez Requêtes partagées.
  6. Développez le noeud d'exemple et sélectionnez Tous les artefacts. Un message demande de définir l'autorisation d'interrogation de toutes les applications sur lesquelles vous exécutez la requête. Cliquez sur Autoriser à côté de chaque application à interroger.
    Ecran d'autorisation utilisateur
  7. Le résultat de la requête doit afficher l'exemple de produit que vous avez créé.

Configuration de TRS pour les utilisateurs Jazz Team Server

  1. Ouvrez la page d'administration de Lifecycle Query Engine : https://nom_hôte_lqe:port/lqe/web.
  2. Cliquez sur Administration > Sources de données > Ajouter une source de données.
  3. Dans la boîte de dialogue Ajouter une source de données, sélectionnez http://nom_hôte:port/jts/trsUsers et ajoutez le libellé Utilisateurs. Acceptez les valeurs par défaut restantes et cliquez sur Terminer.

Commentaires en retour