Création et modification d'une connexion à un référentiel externe

Une connexion de référentiel externe est un élément Rational Team Concert dont les propriétés contiennent des informations dont le Jazz Team Server a besoin pour créer une connexion à un référentiel externe. Vous devez créer une connexion à un référentiel externe pour la passerelle ClearQuest.
Avant de commencer

Pour créer, modifier et supprimer des connexions à des référentiels externes, vous devez disposer d'une licence d'accès Developer ou ClearQuest Connector Client. En outre, la zone de projet doit être configurée pour octroyer des droits à votre rôle utilisateur. Pour définir des droits d'accès, ouvrez la zone de projet, cliquez sur l'onglet Configuration du processus, cliquez sur Configuration de projet > Droits d'accès, sélectionnez un rôle, puis sélectionnez Connecteurs d'élément dans la liste Actions autorisées.

A propos de cette tâche

Vous pouvez utiliser l'assistant d'installation de ClearQuest Connector pour créer une connexion à un référentiel externe. Cette rubrique illustre la création d'une connexion à un référentiel externe à l'aide du client Rational Team Concert Eclipse. Elle montre également comment désactiver ou activer la synchronisation sortante de la connexion à un référentiel externe. Si vous créez une connexion à un référentiel externe à l'aide de l'assistant d'installation de ClearQuest Connector, vous devez activer la synchronisation sortante pour cette connexion. L'assistant crée la connexion à un référentiel externe avec la synchronisation sortante désactivée.

Pour créer une connexion à un référentiel externe, procédez comme suit :

  1. Connectez-vous au client Rational Team Concert.
  2. Dans la vue Artefacts de l'équipe, cliquez à l'aide du bouton droit de la souris sur la connexion au référentiel et sélectionnez Administrer > Règles de synchronisation. Dans la vue Règles de synchronisation, cliquez à l'aide du bouton droit de la souris sur Connexions au référentiel externe et sélectionnez Nouveau > Connexion au référentiel externe.
  3. Si vous êtes connecté à plusieurs référentiels Jazz, sélectionnez celui pour lequel vous souhaitez créer une connexion de référentiel externe. Cliquez sur Suivant. Dans la fenêtre Connexion au référentiel externe, entrez un nom pour la connexion dans la zone Nom. Entrez l'URI de la passerelle ClearQuest dans la zone Informations de connexion. Par exemple : http://YOUR-CQ-GATEWAY-HOST:8081/cqconnector/gateway. Si le serveur Tomcat qui héberge la passerelle ClearQuest est configuré pour demander l'authentification des utilisateurs pour ses demandes de service, renseignez les zones ID utilisateur et Mot de passe. Sinon, ne les renseignez pas. L'ID utilisateur et le mot de passe que vous entrez doivent correspondre à ceux spécifiés dans le fichier tomcat-users.xml du répertoire répertoire-installation/gateway/tomcat/conf.

    Vous pouvez restreindre l'accès à la connexion de référentiel externe en définissant des droits d'accès dans une zone de projet, puis en sélectionnant cette zone de projet dans la zone Zone de projet. Une fois que vous avez défini une zone de projet pour une connexion de référentiel externe, vous ne pouvez pas la modifier. Si vous devez affecter la zone à une autre zone de projet ou à aucune zone de projet, vous devez supprimer la connexion au référentiel externe, puis en créer une nouvelle.

    Si vous devez arrêter de manière temporaire la synchronisation du serveur Jazz vers cette passerelle ClearQuest, sélectionnez Désactiver la synchronisation sortante automatique. Vous pouvez désactiver la synchronisation sortante lorsque vous effectuez des opérations de maintenance sur la base de données d'utilisateurs ClearQuest et qu'elle est momentanément disponible. Pour activer la synchronisation sortante, désélectionnez la case Désactiver la synchronisation sortante automatique. Cliquez sur Sauvegarder pour sauvegarder la connexion au référentiel externe.

    Les numéros de port par défaut des connexions de référentiel externe sont 8444 pour les connexions SSL (Secure Sockets Layer) et 8081, pour les connexions non SSL. Pour modifier un numéro de port par défaut, éditez le fichier server.xml dans le répertoire /jazz/connectors/gateway/tomcat/conf. Pour désactiver les connexions non SSL et configurer le serveur Tomcat de sorte qu'il requiert l'authentification des utilisateurs, procédez comme suit :

    1. Démarrez et arrêtez la passerelle ClearQuest, qui étend le fichier cqconnector.war.
    2. Editez le fichier server.xml dans le répertoire répertoire-installation/gateway/tomcat/conf pour mettre en commentaire cet élément :
      <Connector port="8081" maxHttpHeaderSize="8192"
          maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
          enableLookups="false" redirectPort="8444" acceptCount="100"
          connectionTimeout="20000" disableUploadTimeout="true" />
    3. Editez le fichier web.xml du répertoire répertoire-installation/gateway/tomcat/webapps/cqconnector/gateway/WEB-INF pour supprimer la mise en commentaire de l'élément suivant :
      <security-constraint>
         <web-resource-collection>
            <web-resource-name>secure</web-resource-name>
            <url-pattern>/*</url-pattern>
         </web-resource-collection>
         <auth-constraint>
            <role-name>*</role-name>
         </auth-constraint>
         <user-data-constraint>
            <transport-guarantee>CONFIDENTIAL</transport-guarantee>
         </user-data-constraint>
      </security-constraint>
    4. Ouvrez le fichier tomcat-users.xml du répertoire /jazz/connectors/gateway/tomcat/conf. L'ID utilisateur et le mot de passe par défaut sont cqconnector. Modifiez le mot de passe. Modifiez éventuellement l'ID utilisateur.
    5. Par défaut, le mot de passe enregistré dans le fichier tomcat-users.xml est enregistré en clair, mais vous pouvez le chiffrer puis configurer Tomcat pour qu'il le reconnaisse. Vous devez pour cela utiliser la commande repotools –convertTomcatUsers. Accédez au répertoire JazzInstallDir/server/repotools. Entrez la commande puis précisez le chemin du fichier tomcat-users.xml. Par exemple :
      repotools –convertTomcatUsers tomcatUsersPath=répertoire_d_installation/gateway/tomcat/conf/tomcat-users.xml

      Le fichier tomcat-users.xml converti est nommé tomcat-users.xml.converted. Renommez-le tomcat-users.xml. Si toutefois vous deviez modifier le mot de passe, vous devez le faire sur une copie du fichier original non codé, puis exécuter à nouveau la commande repotools –convertTomcatUsers. Veuillez conserver à cet effet une copie du fichier original non codé en lieu sûr.

      Après avoir exécuté la commande, éditez le fichier server.xml dans le répertoire /jazz/connectors/gateway/tomcat/conf de la maière suivante :

      Mettez en commentaire l'élément suivant :

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                   resourceName="UserDatabase"/>

      Supprimez la mise en commentaire de l'élément suivant :

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                   resourceName="UserDatabase" 
                   digest="SHA-1"
                   digestEncoding="UTF-8"/>
Résultats
La connexion de référentiel externe que vous créez apparaît sous le noeud Connexions au référentiel externe de la vue Règles de synchronisation.

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