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

Si vous utilisez Rational Engineering Lifecycle Manager, des étapes de configuration sont requises pour configurer les produits en tant que fournisseurs TRS et pour permettre à Lifecycle Query Engine d'accéder à leurs données.

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, définissez 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.

Prérequis :
Important : Si votre application se trouve sur un serveur Jazz Team Server différent de celui où se trouve LQE, les clés générées pendant cette tâche seront réutilisées ultérieurement lors de l'ajout de sources de données dans Lifecycle Query Engine comme décrit dans la rubrique : Génération de l'index LQE. Notez bien le nom et la valeur confidentielle de chaque clé.

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. Effectuez ces étapes seulement si les applications CCM, QM et RM se trouvent sur un serveur Jazz Team Server distinct.

  1. Créez la 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. Pour plus d'informations sur les préférences d'indexation permanente, consultez : Indexation de vos données avec Lifecycle Query Engine (LQE).

Configuration de DOORS et DOORS Web Access comme fournisseurs TRS

Rational DOORS Web Access est fourni avec plusieurs utilisateurs et mots de passe par défaut pour l'intégration TRS. Vous devez modifier les paramètres de configuration associés à ces utilisateurs, comme décrit 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.
  • 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 [DWA_path]\server\festival\config\festival.xml.
    1. Recherchez la section Configurable system properties.
    2. Ajoutez les propriétés répertoriées dans le tableau suivant.
      Format des propriétés :
      <f:property name="propriété_figurant_dans_le_tableau" value="valeur_appropriée_ou_valeur_par_défaut_figurant_dans_le_tableau" />
    Tableau 1. Propriétés du fichier Festival.xml pour TRS et LQE
    Propriété Description/Valeur
    functional.user.consumer.key Clé de consommateur associée à l'utilisateur fonctionnel LQE. Cette clé 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.
    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.
    functional.user.name Nom de l'utilisateur fonctionnel LQE. Ce nom d'utilisateur doit être un utilisateur valide Rational DOORS. Vérifiez que l'ID utilisateur DOORS que vous utilisez dans le fichier festival.xml existe et qu'il a un accès complet aux projets et aux artefacts que vous exposez dans le jeu de documents.
    functional.user.password Mot de passe de l'utilisateur fonctionnel LQE.
    trs.db.user Nom d'utilisateur de l'intégration TRS. Pour simplifier, utilisez le nom d'utilisateur par défaut trs.db.user. Si cette propriété n'est pas spécifiée, le système utilise les valeurs par défaut.
    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. La valeur par défaut est dwaTrsPa11word. Si cette propriété n'est pas spécifiée, le système utilise les valeurs par défaut.
    trs.page.size Nombre de ressources TRS à inclure dans une page. La valeur par défaut est 250. Si cette propriété n'est pas spécifiée, le système utilise les valeurs par défaut.
    trs.enable Définissez la valeur true.
    L'extrait suivant du fichier festival.xml montre un exemple de propriétés liées à TRS :
    <f:property name="functional.user.consumer.key" value="xyz"/> 
    <f:property name="functional.user.consumer.secret" value="xyz" />
    <f:property name="functional.user.name" value="Administrator" /> 
    <f:property name="functional.user.password" value="qwert6" /> 
    <f:property name="trs.enable" value="true" />
  2. Facultatif : Ouvrez le fichier derby.properties dans un éditeur. Ce fichier se trouve dans le répertoire installation_dwa/derby.
  3. Facultatif : 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. Initialisez la base de données TRS. Exécutez les scripts suivants :
    • Pour Windows :
      installation_dwa/derby.start.bat
      installation_dwa/derby/scripts/init_trs.bat
    • Pour Linux :
      installation_dwa/derby.start.sh
      installation_dwa/derby/scripts/init_trs.sh
  5. Connectez-vous au client Rational DOORS comme un utilisateur de type Gestionnaire de base de données ou Administrateur.
  6. Sélectionnez Fichier > OSLC > Clés locales. Dans la fenêtre Clés locales, cliquez sur Ajouter. Utilisez les valeurs qui sont spécifiées dans le fichier festival.xml.
    • Nom du consommateurs : Tout nom. LQE est recommandé.
    • Clé de consommateur : L'ensemble de valeurs pour la propriété functional.user.consumer.key.
    • Valeur confidentielle du consommateur : L'ensemble de valeurs pour la propriété functional.user.consumer.secret.
    Cliquez sur Enregistrer, puis sur OK.
  7. Sélectionnez Fichier > OSLC > Jeux de documents. Dans la fenêtre Sélectionner des projets, sélectionnez les projets, dossiers et modules que vous voulez exposer à LQE.
  8. Sélectionnez tous les modules requis dans le panneau Sélection de modules. Cliquez sur Appliquer.

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

  1. Accédez à https://nom_hôte:port/lqe/web
  2. Sélectionnez Administration dans le menu de la 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 de DOORS. Sélectionnez l'URL de TRS. Entrez un libellé et sélectionnez Spécification des 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 de Data Source 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. Dans l'exemple ci-dessous, la valeur xyz est un exemple.
    <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://nom_hô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://nom_hô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. Cliquez sur le nom de votre projet, puis cliquez sur OK puis sur Sauvegarder.
    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 exemple de projet et de produit afin de vérifier que l'index est bien 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 montrant 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 vous demande d'autoriser toutes les applications sur lesquelles vous exécutez la requête. Dans la page Autorisation utilisateur, https://nom_hôte_relm:port/lqe/web/auth, cliquez sur Autoriser en regard de chaque application que vous voulez interroger.
    Ecran d'autorisation utilisateur
  7. Le résultat de la requête affiche 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.

Etape suivante

Après avoir configuré vos applications en tant que fournisseurs TRS, suivez les étapes de la rubrique Exécuter une requête pour tester ou déboguer pour valider votre configuration.


Commentaires