Modification des paramètres du service Connector

Le fichier cqconnector.properties contient les valeurs de paramètre sous lesquelles la passerelle ClearQuest Gateway et l'utilitaire de ligne de commande synctool sont exécutés.
A propos de cette tâche

L'assistant d'installation de ClearQuest Connector met à jour le fichier cqconnector.properties en fonction des choix que vous effectuez dans l'assistant. Si vous avez l'intention de déployer ClearQuest Connector sur l'ordinateur sur lequel vous exécutez l'assistant, vous n'avez pas besoin d'éditer le fichier cqconnector.properties. Si vous avez l'intention de déployer ClearQuest Connector sur un autre ordinateur, tel qu'un ordinateur Linux®copiez le fichier cqconnector.properties sur cet ordinateur, puis éditez-le de sorte que les noms de chemin d'accès spécifiés dans les paramètres soient corrects.

Le tableau ci-après décrit les paramètres du ClearQuest Connector .
Tableau 1. Paramètres du ClearQuest Connector
Paramètre Description
com.ibm.rational.interop.pollingPeriod Période d'interrogation, qui contrôle la fréquence à laquelle la passerelle ClearQuest recherche les modifications apportées à la base de données d'utilisateurs de ClearQuest. La période d'interrogation par défaut est de 60 secondes.
com.ibm.team.uris URI (Uniform Resource Identifier) du serveur Jazz. L'URI par défaut est https://cqconnector:cqconnector@localhost:9443/jazz. Utilisez un point-virgule (;) pour séparer les entrées de plusieurs serveurs Jazz. Vous devez créer l'utilisateur Jazz cqconnector ou remplacer cqconnector par le nom d'un autre utilisateur Jazz. L'utilisateur Jazz (cqconnector ou autre) doit avoir une licence Jazz ClearQuest Connector ou Developer. Si vous utilisez cqconnector comme ID utilisateur, modifiez bien le mot de passe par défaut (cqconnector).
cq.dbSetDbName Référentiel de schéma ClearQuest et base de données d'utilisateurs. Le référentiel de schéma par défaut est sample_schema_repo. La base de données d'utilisateurs par défaut est SAMPL. Le format est nom-connexion-référentiel-schéma/nom-base-données-utilisateurs.
cq.orderedProperties.type-enregistrement Liste de zones séparées par des virgules qui indique l'ordre dans lequel le ClearQuest Connector doit définir les valeurs de ces zones lors des opérations de synchronisation sortante. Vous pouvez définir le paramètre de chaque type d'enregistrement qui possède une règle de synchronisation. Les zones que vous ne spécifiez pas dans la liste sont traitées après celles de la liste. Il se peut que vous deviez spécifier l'ordre si vos types d'enregistrement ClearQuest contiennent des points d'ancrage qui établissent des dépendances entre les zones.

Une autre manière de spécifier l'ordre consiste à utiliser la propriété Zones dépendantes du web sur les zones de la définition de formulaire dans ClearQuest Designer. Si vous spécifiez à la fois la propriété Zones dépendantes du web et le paramètre cq.orderedProperties, le ClearQuest Connector utilise l'ordre spécifié avec le paramètre cq.orderedProperties.

cq.password Mot de passe de connexion à la base de données utilisateur ClearQuest. La passerelle ClearQuest et l'outil d'importation utilisent ce mot de passe et le nom d'utilisateur que vous spécifiez avec le paramètre cq.userId pour se connecter à la base de données d'utilisateurs ClearQuest et extraire les enregistrements que vous souhaitez importer dans un référentiel Jazz. La valeur par défaut est cqconnector. N'oubliez pas de modifier le mot de passe par défaut.
cq.userId Nom d'utilisateur de connexion à la base de données d'utilisateurs ClearQuest. La passerelle ClearQuest et l'outil d'importation utilisent ce nom d'utilisateur et le mot de passe que vous spécifiez avec le paramètre cq.password pour se connecter à la base de données d'utilisateurs ClearQuest et extraire les enregistrements que vous souhaitez importer dans un référentiel Jazz. La valeur par défaut est cqconnector. Cet utilisateur doit disposer des droits de l'éditeur SQL.
cq.queryTreeRoot Nom du chemin d'accès complet du dossier racine qui contient le ou les dossiers spécifiques à la zone de projet des requêtes que vous utilisez pour filtrer les enregistrements à synchroniser avec les éléments Rational Team Concert. Vous pouvez spécifier une requête pour chaque type d'enregistrement que vous synchronisez par zone de projet. Vous devez créer les requêtes de sorte qu'elles ne sélectionnent pas d'enregistrement ClearQuest à synchroniser avec plusieurs zones de projet sur le même Jazz Team Server.

Le dossier racine peut se trouver à tout niveau de la hiérarchie des dossiers sous Requêtes publiques ou Requêtes personnelles, mais sa hiérarchie doit se présenter comme suit : dossier-racine/dossier-nom-zone-projet. Les requêtes doivent être stockées directement dans les dossiers de la zone de projet. Vous pouvez avoir plusieurs dossiers de zone de projet. Le nom de chaque dossier de zone de projet doit correspondre au nom de zone de projet correspondant dans le référentiel Jazz.

Vous devez spécifier une valeur pour ce paramètre. Le dossier racine des requêtes que vous spécifiez doit exister et contenir un dossier pour chaque zone de projet avec laquelle vous prévoyez de synchroniser des enregistrements et des éléments de travail. Si un dossier de zone de projet ne contient pas de requête pour un type d'enregistrement qui possède une règle de synchronisation, le ClearQuest Connector tente de synchroniser tous les enregistrements de ce type.

   

Pour modifier les paramètres, procédez comme suit :

  1. Accédez au dossier répertoire_installation\gateway. Ouvrez le fichier cqconnector.properties.
  2. Si nécessaire, modifiez les valeurs des paramètres conformément à votre environnement.
    1. Editez la valeur du paramètre com.ibm.team.uris pour qu'elle pointe vers l'emplacement du serveur ou des serveurs Jazz. Par défaut, la passerelle ClearQuest tente de se connecter au serveur Jazz en tant qu'utilisateur cqconnector. Vous devez créer l'utilisateur Jazz cqconnector ou remplacer cqconnector par le nom d'un autre utilisateur Jazz. L'utilisateur Jazz (cqconnector ou autre) doit avoir une licence Rational Team Concert ClearQuest Connector ou Developer. Pour spécifier un autre utilisateur, insérez nom-utilisateur[:motdepasse]@ avant le nom d'hôte. Par exemple : https://chris:chris_pw@localhost:9443/jazz. Utilisez un point-virgule (;) pour séparer les entrées de plusieurs serveurs Jazz.
    2. Editez la valeur du paramètre cq.dbSetDbName pour identifier votre référentiel de schéma et votre base de données d'utilisateurs.
    3. Editez la valeur du paramètre com.ibm.rational.interop.pollingPeriod si vous souhaitez modifier la période d'interrogation par défaut de 60 secondes.
    4. Pour filtrer les enregistrements ClearQuest à synchroniser, créez des requêtes pour chaque type d'enregistrement qui possède une règle de synchronisation. Stockez les requêtes dans des dossiers spécifiques aux zones de projet, sous le dossier racine. Editez le paramètre cq.queryTreeRoot pour identifier le nom complet du chemin d'accès du dossier racine. Par exemple : Public Queries/Jazz CQ Connector. Même si vous ne souhaitez pas filtrer les enregistrements, vous devez créer un dossier racine et un dossier de zone de projet pour chaque zone de projet avec laquelle vous prévoyez de synchroniser des enregistrements et des éléments de travail.
    5. Spécifiez les noms d'utilisateur et les mots de passe de connexion à ClearQuest à l'aide des paramètres cq.userId et cq.password. L'utilisateur que vous spécifiez avec le paramètre cq.userId doit disposer des droits de l'éditeur SQL.
    6. Si l'une des zones des types d'enregistrement ClearQuest que vous prévoyez de synchroniser contient des points d'ancrage qui établissent des dépendances avec d'autres zones et que vous n'utilisez pas la propriété Zones dépendantes du web dans la définition de formulaire ClearQuest pour spécifier l'ordre dans lequel les valeurs des zones doivent être définies, définissez le paramètre cq.orderedProperties.type-enregistrement. Un point d'ancrage associé à une zone peut utiliser la valeur qu'un utilisateur entre dans cette zone pour déterminer comment définir la valeur d'une autre zone. Dans ce scénario, vous devez identifier l'ordre dans lequel les points d'ancrage doivent être exécutés lors des opérations de synchronisation sortante pour que les zones d'enregistrement ClearQuest reçoivent les valeurs appropriées. Par exemple : cq.orderedProperties.Defect=Headline,Type,Product,Component. Cet exemple spécifie que la zone Titre du type d'enregistrement Incident doit être défini en premier, suivi des zones Type, Produit et Composant.

      Si vous spécifiez à la fois la propriété Zones dépendantes du web et le paramètre cq.orderedProperties, le ClearQuest Connector utilise l'ordre spécifié avec le paramètre cq.orderedProperties.

    7. Fermez et sauvegardez le fichier cqconnector.properties.
Que faire ensuite
Remarque : Le fichier cqconnector.properties contenant les noms de connexion et les mots de passe des comptes d'utilisateur ClearQuest et Jazz, définissez bien les droits sur ce fichier de sorte qu'il ne soit lisible que par les utilisateurs autorisés.

Commentaires en retour

Etes-vous satisfait ? Vous pouvez faire part de vos commentaires à l'adresse Jazz.net (enregistrement requis) : Commentaire dans les forums ou soumettre un bogue