Configuration de Rational DOORS Web Access en tant que fournisseur TRS

Vous pouvez configurer IBM® Rational DOORS Web Access en tant que fournisseur TRS (Tracked Resource Sets) en éditant les fichiers de configuration et en exécutant les fichiers de traitement par lots Derby.

Pourquoi et quand exécuter cette tâche

Rational DOORS Web Access et Derby sont livrés avec plusieurs utilisateurs et mots de passe par défaut pour l'activation de TRS. Si vous modifiez ces noms ou mots de passe, vous devez également modifier les paramètres de configuration associés à ces utilisateurs, comme décrit dans la procédure ci-dessous. L'intégration fait appel aux utilisateurs suivants :
Utilisateur_fonctionnel_LQE
Cet utilisateur Rational DOORS standard gère les requêtes LQE entre une application client TRS intégrée et Rational DOORS Web Access. S'il possède un nom d'utilisateur et un mot de passe différents des valeurs par défaut, celles-ci doivent correspondre aux entrées du fichier festival.xml, tel que décrit dans la procédure ci-dessous.
trs.db.user
Cet utilisateur de base de données Derby peut accéder aux données de la base de données TRS et est utilisé par Rational DOORS Web Access pour extraire les données de la base de données. Pour utiliser des données d'identification autres que celles par défaut, vous devez créer les entrées correspondantes dans le fichier festival.xml. Si vous modifiez le mot de passe, vous devez entrer le nouveau dans le fichier de propriétés Derby.
derby.user.admin
Cet administrateur de base de données n'offre pas actuellement de fonctions pour Rational DOORS Web Access. Vous pouvez définir un mot de passe pour cet utilisateur dans la base de données Derby.
Important : Les administrateurs doivent prendre des mesures pour préserver l'intégrité de la base de données Derby et prévenir sa corruption. Pour plus d'informations, voir "Maintaining database integrity" dans Derby Server and Administration Guide.

Procédure

  1. Arrêtez tous les composants de Rational DOORS Web Access, comme indiqué dans Démarrage, arrêt et suppression de Rational DOORS Web Access.
  2. Créez une copie de sauvegarde du fichier festival.xml et ouvrez le fichier d'origine dans un éditeur. Ce fichier se trouve dans le répertoire répertoire_installation_dwa\server\festival\config.
  3. Entrez les valeurs de propriété suivantes pour l'utilisateur fonctionnel LQE et l'utilisateur TRS :
    ForceHttpsForAuthenticationForOAuth
    Définissez cette valeur sur true.
    functional.user.consumer.key
    Cette clé de consommateur est associée à l'utilisateur fonctionnel LQE. LQE utilise cette clé pour accéder à DOORS TRS. Elle doit correspondre à l'entrée Clé du consommateur dans la fenêtre Clés locales de la configuration Rational DOORS. La valeur par défaut est LQE Functional User Key. Cette propriété n'est obligatoire dans le fichier festival.xml que si vous utilisez une valeur autre que celle par défaut.
    functional.user.consumer.secret
    Cette valeur confidentielle est associée à l'utilisateur fonctionnel LQE. LQE utilise cette clé pour accéder à DOORS TRS. Elle correspond aux entrées Secret OAuth dans la fenêtre Clés locales de la configuration Rational DOORS. La valeur par défaut est qwert6. Cette propriété n'est obligatoire dans le fichier festival.xml que si vous utilisez une valeur autre que celle par défaut.
    functional.user.name
    Cette propriété désigne le nom de l'utilisateur fonctionnel LQE. Il doit s'agir d'un utilisateur Rational DOORS standard disposant de droits de lecture sur toutes les données Rational DOORS destinées à être utilisées dans LQE. Cette valeur doit correspondre à l'entrée Nom du consommateur dans la fenêtre Clés locales de la configuration Rational DOORS. La valeur par défaut est Utilisateur_fonctionnel_LQE. Cette propriété n'est obligatoire dans le fichier festival.xml que si vous utilisez une valeur autre que celle par défaut.
    functional.user.password
    Cette propriété désigne le mot de passe de l'utilisateur fonctionnel LQE. La valeur par défaut est qwert6. Cette propriété n'est obligatoire dans le fichier festival.xml que si vous utilisez une valeur autre que celle par défaut.
    trs.db.user
    Cette propriété est le nom d'utilisateur pour l'activation TRS. Le nom d'utilisateur par défaut est trs. Cette propriété n'est obligatoire dans le fichier festival.xml que si vous utilisez une valeur autre que celle par défaut.
    trs.db.password
    Cette propriété désigne le mot de passe de trs.db.user. La valeur par défaut est dwaTrsPa11word. Cette propriété n'est obligatoire dans le fichier festival.xml que si vous utilisez une valeur autre que celle par défaut. Si vous utilisez une valeur autre que celle par défaut, vous devez entrer le nouveau mot de passe dans le fichier de propriétés Derby, comme décrit dans les étapes suivantes de la procédure.
    trs.page.size
    Cette propriété indique le nombre de ressources TRS à inclure dans une page. La valeur par défaut est 250.
    trs.enable
    Définissez cette valeur sur true.
    L'extraction suivante issue du fichier festival.xml donne un exemple de propriétés liées à TRS :
    <f:property name="ForceHttpsForAuthenticationForOAuth" value="true"/> 
    <f:property name="functional.user.consumer.key" value="LQE Functional User Key"/> 
    <f:property name="functional.user.consumer.secret" value=qwert6"/> 
    <f:property name="functional.user.name" value="LQE Functional User"/> 
    <f:property name="functional.user.password" value="qwert6"/> 
    <f:property name="trs.enable" value="true"/>
  4. Enregistrez et fermez le fichier festival.xml.
  5. Si vous modifiez la valeur par défaut de trs.db.password dans le fichier festival.xml, procédez comme suit :
    1. Ouvrez le fichier derby.properties dans un éditeur. Ce fichier se trouve dans le répertoire installation_dwa/derby.
    2. Remplacez la valeur derby.user.trs. Le fichier derby.properties inclut les valeurs suivantes :
      derby.user.trs
      Mot de passe de la propriété trs.db.user que vous avez spécifié dans le fichier festival.xml. La valeur par défaut est dwaTrsPa11word.
      derby.user.admin
      Mot de passe de l'administrateur de base de données Derby. Actuellement, cet utilisateur n'offre pas de fonctions pour Rational DOORS Web Access. La valeur par défaut est dwaTrsPa11word.
  6. Démarrez tous les composants de Rational DOORS Web Access, comme indiqué dans Démarrage, arrêt et suppression de Rational DOORS Web Access.

Que faire ensuite

Une fois l'intégration à une application client TRS configurée à l'aide de relations OSLC amies, vous devez enregistrer Rational DOORS en tant que fournisseur TRS dans l'application client. Pour obtenir un exemple de cette procédure, dans la documentation pour IBM Rational Engineering Lifecycle Management, voir la section "Register applications as TRS providers for the Lifecycle Query Engines".

LQE, qui est utilisé par une application client TRS, notamment Rational Engineering Lifecycle Management, génère un indice principal (ou base de données) de données provenant de plusieurs outils de gestion du cycle de vie. Chaque outil du fournisseur TRS publie ses données via un ensemble TRS. LQE peut collecter ou indexer les données provenant de chaque outil. Les équipes peuvent écrire des requêtes, qui sont comme des rapports, pour les données indexées en langage SPARQL. Lorsque vous ajoutez une source de données pour Rational DOORS dans l'application LQE Administration, définissez les valeurs suivantes :
  • Nombre d'unités d'exécution pour l'indexation initiale : 1
  • Nombre d'unités d'exécution pour l'indexation incrémentielle : 1
  • Fréquence de régénération : 60
Dans l'onglet Administration, cliquez sur Configuration > Propriétés avancées, puis définissez les valeurs de délai d'attente HTTP ci-dessous. La valeur par défaut est 60 secondes. Augmentation des deux valeurs :
  • Délai de connexion (minimal) : 5 minutes (300 secondes)
  • Délai d'attente du socket (minimal) : 15 minutes (900 secondes)

Commentaires en retour