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 : - Démarrez le serveur de chaque application à configurer.
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.
- Ouvrez la console d'administration de JTS dont l'adresse est https://nom_hôte:port/jts/admin.
- Sélectionnez Utilisateurs > Utilisateurs actifs.
- 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.
- 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.
- 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.
- Créez la clé de consommateur entrant LQE pour CCM. Ouvrez la page d'administration CCM : https://nom_hôte:port/ccm/admin.
- 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.
- Accédez à la liste des clés autorisées et modifiez l'entrée LQE en cliquant sur l'icône de crayon.
- Dans la boîte de dialogue Edition des propriétés de la clé du consommateur, cliquez sur le lien Sélectionner des utilisateurs....
- 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.
- 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.
- 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.
- 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.
- Cliquez sur Administration > Sources de données > Ajouter une source de données.
- 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.
- 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.
- 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.
- 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.
- 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.
- Ouvrez le fichier [DWA_path]\server\festival\config\festival.xml.
- Recherchez la section Configurable system properties.
- 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" />
- Facultatif : Ouvrez le fichier derby.properties dans un éditeur. Ce fichier se trouve dans le répertoire installation_dwa/derby.
- 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. |
- Initialisez la base de données TRS. Exécutez les scripts suivants :
- Connectez-vous au client Rational DOORS comme un utilisateur de type Gestionnaire de base de données ou Administrateur.
- Sélectionnez . 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.
- Sélectionnez . Dans la fenêtre Sélectionner des projets,
sélectionnez les projets, dossiers et modules que vous voulez exposer
à LQE.
- 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
- Accédez à https://nom_hôte:port/lqe/web
- Sélectionnez Administration dans le menu de la barre d'outils.
- Dans la page des sources de données, sélectionnez Ajouter une source de données
- 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
- 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"/>
- 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
- 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.
- Sélectionnez Serveur > Consommateurs (entrants), entrez les informations suivantes et cliquez sur Enregistrer :
- Nom : LQE
- Valeur confidentielle : xyz
- Digne de confiance : yes
- Accédez à la liste des clés autorisées et modifiez l'entrée LQE en cliquant sur l'icône de crayon.
- Dans la boîte de dialogue Edition des propriétés de la clé du consommateur, cliquez sur le lien Sélectionner des utilisateurs....
- 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.
- Accédez à https://nom_hôte:port/dm/web
- Connectez-vous comme administrateur.
- 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.
- 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.
- Cliquez sur Administration > Sources de données > Ajouter une source de données.
- 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éé.
- Ouvrez la page d'administration de Lifecycle Query
Engine : https://nom_hôte_lqe:port/lqe/web.
- Cliquez sur Administration > Sources de données > Ajouter une source de données.
- 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.
- Pour tester l'index, ouvrez Rational Engineering
Lifecycle Manager : https://nom_hôte_relm:port/relm/web.
- Sélectionnez un exemple de projet. Dans le menu Requêtes, sélectionnez Requêtes partagées.
- 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.
- 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
- Ouvrez la page d'administration de Lifecycle Query
Engine : https://nom_hôte_lqe:port/lqe/web.
- Cliquez sur Administration > Sources de données > Ajouter une source de données.
- 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.