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
, 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 :
- Connectez-vous au client Rational Team Concert.
- 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
. 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
.
- 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 :
- Démarrez et arrêtez la passerelle ClearQuest, qui étend le fichier
cqconnector.war.
- 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" />
- 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>
- 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.
- 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.