Cette rubrique décrit les étapes nécessaires à la mise à niveau de ClearQuest Synchronizer à partir de l'édition précédente.
Procédure
- Désactivez la synchronisation sortante pour la connexion au référentiel externe. Dans le client Rational Team Concert pour l'environnement de développement intégré Eclipse, affichez la vue Règles de synchronisation. Développez le noeud Connexions au référentiel externe. Cliquez deux fois sur la connexion au référentiel externe pour l'ouvrir. Sélectionnez Désactiver la synchronisation sortante automatique. Cliquez sur OK.
- Désactivez la synchronisation sortante pour Jazz Team
Server.
Dans la page d'administration du client Web, cliquez sur Propriétés avancées. Accédez au composant Interopération d'élément.
Pour com.ibm.team.interop.service.internal.InteropService,
cliquez sur Editer. Pour Synchronisation sortante activée, sélectionnez false dans la liste déroulante. Cliquez sur Sauvegarder.
- Arrêtez la passerelle ClearQuest.
- Arrêtez Jazz Team
Server.
- Mettez à niveau le serveur. Voir Mise à niveau à partir de la version 2 (processus en deux étapes) ou Mise à niveau vers la version
4.0.
- Démarrez le serveur et vérifiez les points suivants :
- Vous pouvez vous connecter avec le compte utilisateur Jazz
que ClearQuest Connector utilise et vous pouvez vous connecter à la zone de projet.
- La connexion au référentiel externe existe. Reportez-vous à la vue Règles de synchronisation.
- Les règles de synchronisation existent. Reportez-vous à la vue Règles de synchronisation.
- Les éléments de travail que vous avez créés précédemment et synchronisés avec les enregistrements ClearQuest existent.
- La synchronisation sortante est toujours désactivée pour Jazz Team
Server.
- Installez la nouvelle version de ClearQuest Synchronizer.
Voir Installation de Rational Team Concert ClearQuest Synchronizer à l'aide d'IBM Installation Manager.
Remarque : Si vous procédez à une mise à niveau à partir de la version 3.X, vous pouvez utiliser l'option Mise à jour dans le gestionnaire d'installation. Si vous procédez à une mise à niveau à partir de la version 2.X, vous devez choisir l'option d'installation puis désinstaller la version 2.X
(voir
Etape 17). Lorsque vous démarrez la version 3.0, le répertoire d'installation par défaut s'appelle ClearQuest Synchroniser au lieu de ClearQuest Connector.
- Accédez au répertoire répertoire_install/ClearQuest
Synchronizer/gateway et démarrez la passerelle ClearQuest.
- Arrêtez la passerelle ClearQuest. Le démarrage puis l'arrêt de la passerelle ClearQuest crée le répertoire
répertoire_install/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector.
- Si vous procédez à une mise à jour à partir de la version 2.X, copiez tout fichier pouvant être configuré par l'utilisateur et qui a été modifié du répertoire d'installation de ClearQuest Connector
2.0.0.2x vers le répertoire d'installation de ClearQuest Synchronizer. En particulier, copiez :
- cqconnector.properties de répertoire_install/ClearQuestConnector/gateway
vers répertoire_install/ClearQuestSynchronizer/gateway.
- log4j.properties de répertoire_install/ClearQuestConnector/gateway
vers répertoire_install/ClearQuestSynchronizer/gateway.
- tomcat-users.xml de répertoire_install/ClearQuestConnector/gateway/tomcat/conf
vers répertoire_install/ClearQuestSynchronizer/gateway/tomcat/conf.
- web.xml de répertoire_install/ClearQuestConnector/gateway/tomcat/webapps/cqconnector/WEB-INF
vers répertoire_install/ClearQuestSynchronizer/gateway/tomcat/webapps/cqconnector/WEB-INF.
Si vous procédez à une mise à niveau à partir de la version 3.X et que vous choisissez l'option Mise à jour dans le gestionnaire d'installation, vous avez modifier les fichiers de configuration stockés dans un répertoire de sauvegarde. Copiez les fichiers de configuration modifiés du répertoire de sauvegarde vers le nouveau répertoire d'installation.
Remarque : Le fichier server.xml utilisé dans les éditions antérieures à 4.0 n'est pas compatible avec
4.0. Par conséquent, vous ne pouvez pas le copier à partir de répertoire-installation/ClearQuestConnector/gateway/tomcat/conf
ou à partir du répertoire de sauvegarde vers répertoire-installation/ClearQuestSynchronizer/gateway/tomcat/conf.
Vous devez plutôt éditer le fichier server.xml 4.0 dans le nouveau répertoire d'installation
(répertoire-installation/ClearQuestSynchronizer/gateway/tomcat/conf)
de façon à ce qu'il contienne toutes les modifications que vous avez apportées à la version antérieures.
- Facultatif. Appliquez la version la plus récente du package JazzInterop à votre schéma
ClearQuest puis mettez à niveau la base de données utilisateur
ClearQuest avec cette nouvelle version de schéma. Voir Mise à niveau de la base de données d'utilisateurs avec une nouvelle version du package JazzInterop pour des détails.
- Démarrez la passerelle ClearQuest.
- Vérifiez le statut de la passerelle dans la page de statut à l'adresse http://host-name.example.com:8081/cqconnector/gateway.
La page doit indiquer que la passerelle accepte toutes les demandes.
- Activez la synchronisation sortante pour la connexion au référentiel externe.
- Activez la synchronisation sortante pour le serveur.
- Vérifiez que la synchronisation fonctionne en effectuant les opérations suivantes :
- Créez plusieurs enregistrements dans la base de données utilisateur ClearQuest. Vérifiez que les éléments de travail correspondants sont créés dans la zone de
projet Rational Team Concert.
- Créez plusieurs éléments de travail dans la zone de projet. Vérifiez que les enregistrements correspondants sont créés dans la base de données utilisateur ClearQuest.
- Editez plusieurs éléments de travail qui ont été synchronisés dans l'édition précédente. Vérifiez que les modifications sont propagées aux enregistrements ClearQuest correspondants.
- Editez plusieurs enregistrements ClearQuest qui ont été synchronisés dans l'édition précédente. Vérifiez que les modifications sont propagées aux éléments de travail correspondants.
- Si vous procédez à une mise à niveau de la version 2.X, ou si vous n'avez pas choisi l'option de mise à jour dans le gestionnaire d'installation, désinstallez la version précédente sur le connecteur ClearQuest. L'opération de désinstallation doit créer un répertoire nommé backup-config-horodatage dans le répertoire
répertoire_install/ClearQuestConnector.
Vérifiez que ce répertoire contient les répertoires et fichiers suivants :
- gateway/cqconnector.properties
- gateway/log4j.properties
- gateway/tomcat/conf (ce répertoire contient plusieurs fichiers et un répertoire Catalina)
- gateway/tomcat/webapps/cqconnector/WEB-INF/web.xml