Mise à niveau vers une topologique d'entreprise entièrement distribuée

Vous pouvez mettre à niveau votre installation de Rational Team Concert vers la version 3.0.1 avec de nouvelles applications CCM et JTS distribuées en suivant la procédure décrite dans cette rubrique.

Avant de commencer

Important : Vérifiez que les horloges de toutes les machines sont synchronisées à l'aide du protocole NTP (Network Time Protocol). L'heure est un élément primordial qui permet à un événement sur un noeud réseau d'être mappé à un événement correspondant sur un autre noeud réseau. Ces problèmes peuvent être évités par un déploiement d'entreprise du service NTP. Pour plus d'informations sur le protocole NTP, visitez http://www.ntp.org/.
Remarque : Les exemples présentés ici concernent Jazz Team Server et l'application Gestion de la configuration et des modifications. Vous pouvez utiliser la même procédure pour l'application Quality Management .

Consultez la rubrique Exemple de topologie d'entreprise Rational Team Concert entièrement distribuée 2.0 à 3.0.1 pour trouver un exemple de la topologie d'entreprise complètement répartie Rational Team Concert 3.0.1.

Lorsque vous distribuez l'application JTS sur un serveur distinct, vérifiez que le deuxième serveur sur lequel vous déployez l'application JTS exécute le même système d'exploitation et utilise la même configuration de serveur d'applications. L'utilisation du même système d'exploitation et du même serveur d'applications facilite la migration des fichiers.

Vérifiez que les deux serveurs utilisent la même méthode d'authentification et le même domaine utilisateur pour leurs utilisateurs.

Passez en revue et considérez Déploiement d'une connexion unique. Si vous utilisez WebSphere, cette opération de déploiement facilitera l'authentification dans un environnement multiserveur.

A la fin des installations de la version 3.0.1 sous "Quel programme désirez-vous démarrer" sélectionnez Aucun. Vous devez exécuter l'assistant de configuration JTS uniquement une fois la migration des fichiers et référentiels terminés.

Préparation des fichiers de configuration

Procédure

  1. Sur la machine A (sur laquelle se trouve le serveur RTC 2.x à mettre à niveau), installez l'application Gestion des modifications et de la configuration (CCM) version 3.0.1 sans Jazz Team Server (JTS) ni les licences d'évaluation de RTC.
    Remarque : Dans le panneau Racine du contexte, sélectionnez bien Utiliser la racine de contexte de Rational Team Concert 2.x.
  2. Sur la machine B, installez l'application Jazz Team Server (JTS) version 3.0.1 et les licences d'évaluation de RTC sans l'application Gestion des modifications et de la configuration sur le serveur qui va devenir le serveur JTS partagé.
    Remarque : Dans le panneau Racine du contexte, sélectionnez bien Utiliser la racine de contexte de Rational Team Concert 2.x.
  3. Sur la machine A, ouvrez une nouvelle fenêtre de commande et accédez à rép_install_3.0.1/server.
  4. Exécutez la commande suivante pour fusionner les fichiers de configuration Jazz et Tomcat :
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=rép_install_2.x/server/conf
    Remarque : Par défaut, la commande -migration_ccm_updateConfigurationFiles met à jour les fichiers de configuration de Jazz et Tomcat. Si Tomcat n'est pas installé et que vous voulez mettre à jour les fichiers de configuration Jazz uniquement, vous devez spécifier le paramètre updateType=JAZZ.
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=rép_install_2.x/server/conf updateType=JAZZ
  5. Sur la machine A, accédez à rép_install_RTC3.0.1/server/conf/jazz et révisez le contenu du fichier teamserver.properties de RTC. Vérifiez particulièrement l'exactitude des entrées de connexion de base de données et d'adresse URL publique pour le nom d'hôte de la machine A.
    ATTENTION :
    Il est essentiel de réviser le contenu des fichiers fusionnés, notamment les entrées de connexion de base de données et d'adresse URL publique dans les deux fichiers teamserveur.properties Jazz et JTS. Le fichier teamserver.properties de Jazz (RTC/CCM) se trouve sur la machine A sous rép_install_3.0.1/server/conf/jazz alors que le fichier teamserver.properties de JTS à éditer et déplacer se trouve sur la machine A sous rép_install_3.0.1/server/jts-migration/conf/jts.

    Il est important d'éditer et de mettre à jour (si nécessaire) les deux fichiers teamserver.properties avec le nom d'hôte du serveur correct sur lequel ils vont se trouver.

    Pour plus d'informations et d'exemples de point de vérification, reportez-vous aux étapes 3 à 6 de la rubrique Préparation des fichiers de configuration dans la section relative à la mise à niveau de Rational Team Concert.

  6. Après avoir édité le fichier teamserver.properties de JTS sur la machine A, copiez-le sur la machine B sous rép_install_3.0.1/server/conf/jts. Effectuez une sauvegarde du fichier teamserver.properties existant avant de le remplacer.
  7. Si vous procédez au déploiement sur Tomcat, vous devez copier les fichiers rép_install_3.0.1/tomcat/conf/tomcat-users.xml et rép_install_3.0.1/tomcat/conf/server.xml de la Machine A dans le dossier rép_install_3.0.1/tomcat/conf de la machine B. Effectuez des copies de sauvegarde des fichiers existants avant de les remplacer.
  8. Si vous procédez au déploiement sur Tomcat et que vous utilisez LDAP, vous devez effectuer les tâches suivantes pour déployer le serveur JTS avec le fichier web.xml édité :
    1. Sur la machine B, démarrez le serveur JTS avec server.startup pour extraire le fichier JTS.war.
    2. Sur la machine B, arrêtez le serveur JTS avec la commande server.shutdown.
    3. Sur la machine B, effectuez une sauvegarde du fichier rép_install_3.0.1/server/tomcat/webapps/jts/WEB-INF/web.xml puis remplacez-le par une copie du fichier web.xml équivalent du serveur A.

Résultats

Cette opération conclut la migration des fichiers de configuration.

Migration de la base de données de référentiel

Cette section décrit les étapes nécessaires à la migration de la base de données de référentiel pour une application JTS distribuée.

Avant de commencer

Avant de poursuivre la migration de la base de données de référentiel, vérifiez que les tâches suivantes ont été exécutées :
  • Une sauvegarde complète hors ligne de la base de données RTC 2.x existante a été effectuée.
  • Les fichiers de configuration sont migrés et en place (teamserver.properties, friendsconfig.rdf, tomcat-users.xml, server.xml, web.xml). Pour plus d'informations, voir Préparation des fichiers de configuration.
  • La base de données de référentiel JTS est créée. Pour plus d'informations, voir Configuration de la base de données.
  • Le serveur Rational Team Concert v2.x a été arrêté.
  • Si vous utilisez Derby pour le serveur Rational Team Concert v2.x, vérifiez que la base de données de référentiel est copiée du répertoire rép_install_2.x/server/repositoryDB vers le répertoire rép_install_3.0.1/server.
  • Pour la migration de WebSphere Application Server :
    • Vérifiez que le serveur RTC 2.x a été arrêté.
    • Arrêtez et désinstallez l'application jazz.war.
    • Modifiez la propriété JAZZ_HOME pour qu'elle reflète le nouveau chemin d'installation (rép_install_3.0.1/server/conf).
    • Modifiez la propriété du pilote JDBC Oracle ou SQL Server si nécessaire. Voir Configuration de WebSphere Application Server.
    • Si nécessaire, ajustez les paramètres de mémoire. Voir Configuration de WebSphere Application Server.
    • Arrêtez et redémarrez WebSphere Application Server.

Procédure

  1. Sur la machine A, ouvrez une fenêtre de commande et placez-vous dans le répertoire rép_install_3.0.1/server.
  2. Exécutez la commande suivante pour ajouter des tables à la base de données :
    repotools-jazz -addTables
  3. Exécutez la commande suivante pour exporter des informations utilisateur à partir de la base de données RTC :
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
  4. Sur la machine A, copiez le fichier jtsData.jar que vous venez de créer sur la machine B dans le répertoire rép_install_3.0.1/server.
  5. Sur la machine B, exécutez la commande suivante pour importer des informations utilisateur dans la base de données JTS :
    Important : Si vous n'utilisez pas la base de données Derby par défaut, vérifiez que la base de données JTS référencée dans le fichier conf/jts/teamserver.properties a été créée et existe.
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
  6. A partir de la machine B, copiez le fichier rtc-mapping.txt que vous venez de créer sur la machine A dans le répertoire rép_install_RTC3.0.1/server.
  7. Sur la machine A, exécutez la commande suivante pour importer des informations utilisateur JTS dans la base de données RTC :
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt

Commandes post-migration de Repository Tools

Procédure

Sur la machine A, exécutez les commandes suivantes afin de régénérer les index :

repotools-jazz -rebuildTextIndices

repotools-jazz -reindex

Résultats

Cette opération conclut la migration de la base de données de référentiel.

Configuration de post-migration

Pourquoi et quand exécuter cette tâche

Les étapes postérieures à la migration permettant de migrer un serveur RTC et de distribuer l'application JTS sont identiques à celles mentionnées pour la migration dans un environnement à serveur unique ; toutefois, vous devez aussi effectuer les tâches suivantes :

Procédure

Pendant le lancement de l'assistant de configuration de Jazz Team Server, l'application CCM n'est pas reconnue automatiquement ni préremplie en raison de l'environnement distribué. Si l'application CCM n'est pas reconnue automatiquement au cours de la configuration de Jazz Team Server, reportez-vous à l'étape 9c dans Exécution de l'assistant de configuration.

Commentaires