Cette rubrique décrit le processus de mise à niveau manuelle de Rational Team Concert version
2 vers la version 3.0.1.
Avant de commencer
Avant de mettre le serveur à niveau, vérifiez que vous disposez d'une copie à jour valide de votre base de données de référentiel
Rational Team Concert version 2.
Vérifiez que les horloges
de tous les serveurs sont synchronisées à l'aide du protocole de synchronisation NTP. L'heure est l'élément critique permettant à un événement d'un noeud de réseau d'être mappé vers un événement correspondant sur un autre noeud. Pour évitez des problèmes, vous pouvez déployer le service NTP dans l'entreprise. Pour plus d'informations sur
NTP, visitez http://www.ntp.org/. De plus, tous les serveurs doivent utiliser la même méthode d'authentification pour leurs utilisateurs.
Si vous utilisez Derby pour le serveur Rational Team Concert version 2, vérifiez que la
base de données de référentiel est copiée du répertoire rép_install_RTC2.X/server/repositoryDB
vers le répertoire rép_install_CCM3.0.1/server/conf/jazz/derby.
Si vous comptez mettre à niveau plusieurs produits, reportez-vous à la rubrique Ordre de mise à niveau pour vous aider à décider par lequel commencer.
Procédure
- Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
- Vérifiez le fichier teamserver.properties version 2 existant pour la propriété
com.ibm.team.repository.server.webapp.url.
Vous devez utiliser la même URL publique dans la version 3.0.1. Si une URL publique n'a pas été définie, utilisez l'interface Web d'administration de la version
2 (Propriétés avancées) pour spécifier l'URL avec nom d'hôte qualifié (https://hostname.example.com:port) avant de procéder à la mise à niveau.
La ligne de l'URL publique dans teamserver.properties devrait être similaire à ceci :
com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
- Arrêtez le serveur version 2.
- Si vous ne l'avez pas encore fait, installez Jazz Team
Server et l'application Gestion des modifications et de la configuration (CCM) dans un nouvel emplacement. Si vous avez déjà installé Jazz Team Server, installez l'application Gestion des modifications et de la configuration.
- Lors de l'installation, sélectionnez Utiliser la racine de contexte de Rational Team Concert 2.x afin de conserver la racine de contexte /jazz.
- A la fin de l'installation, sélectionnez Aucun pour l'option Quel programme désirez-vous démarrer ?.
- Créez une base de données séparée pour Jazz Team Server avec les mêmes paramètres que pour votre base de données version 2 mais avec un nom différent. Pour plus d'informations sur la création de bases de données, reportez-vous à la rubrique Configuration de la base de données.
Remarque : Une base de données Jazz Team Server distincte de la base de données CCM est requise.
Créez une base de données Jazz Team Server si vous ne l'avez pas encore fait.
Important : Ouvrez des fenêtres de ligne de commande distinctes pour
exécuter les commandes repotools des versions 2 et 3. Utilisez des fenêtres de ligne de commande distinctes pour garantir qu'aucun conflit
n'existe entre les variables d'environnement utilisées par les commandes de la
version 2 et de la version 3.
- Accédez à <rép_install_3.0.1CCM>/server et exécutez la commande suivante pour fusionner Jazz et le ficher de configuration
Tomcat (y compris les amis).
repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<rép_install_2.x>/server/conf
Par défaut, la commande
-migration_ccm_updateConfigurationFiles met à jour les fichiers de configuration de Jazz, comme de Tomcat. Si Tomcat n'est pas installé et que vous souhaitez mettre à jour uniquement les fichiers de configuration Jazz, spécifiez le paramètre updateTomcatFiles=false.
Les tâches suivantes sont traitées avec la commande
-migration_ccm_updateConfigurationFiles :
- Fichiers de configuration Jazz :
- teamserver.properties (fusionne un fichier Rational Team Concert dans deux fichiers, pour le serveur d'équipe et pour l'application)
- friendsconfig.rdf (copie d'un fichier Rational Team Concert dans un fichier d'application)
- Fichiers Tomcat :
- tomcat-users.xml (copie)
A faire : Pour la base de données utilisateur Tomcat uniquement. Le fichier tomcat-users.xml est copié (non fusionné avec le fichier existant). Si vous mettez à niveau plusieurs applications CLM avec un JTS commun, vous devez fusionner manuellement les utilisateurs et regrouper les informations dans le fichier tomcat-users.xml. Les informations d'utilisateur et de groupe sont différentes si les utilisateurs font partie de différents groupes, dans différentes applications.
Par exemple, utilisateurA dispose du rôle JazzAdmins dans CCM et du rôle JazzUsers dans QM. En outre, si certains utilisateurs se trouvent dans une application et non dans l'autre ou vice versa, ils doivent manuellement être ajoutés au fichier tomcat-users.xml.
- server.xml (fusionne)
- les fichiers web.xml contenus dans les fichiers war d'application (fusionne un fichier Rational Team Concert dans deux fichiers, pour le serveur d'équipe et pour l'application)
Important : Vous pouvez avoir modifié d'autres fichiers dans Rational Team Concert version 2, par exemple le fichier log4j.properties. Vous devez fusionner ces fichiers manuellement.
Pour plus de détails sur la commande repotools, voir -migration_ccm_updateConfigurationFiles.
A faire : Dans les exemples suivants, l'emplacement du fichier teamserver.properties dépend de l'installation par défaut. Si vous avez changé la disposition des fichiers pour votre déploiement, assurez-vous d'indiquer les emplacements corrects.
De plus, les étapes suivantes supposent que le déploiement est effectué sur un seul serveur.
Par défaut, la valeur du paramètre newJTSHome est dérivée de celle du paramètre
newApplicationHome. Si vous utilisez des serveurs distincts pour CCM et Jazz Team Server, spécifiez le paramètre newJTSHome afin de le faire pointer vers l'emplacement de Jazz Team Server. Ainsi, les propriétés LDAP, de messagerie électronique et d'emplacement de base de données sont fusionnées à partir du fichier teamserver.properties.
Les fichiers de configuration Tomcat sont également copiés vers l'emplacement Jazz Team
Server.
- Vérifiez que les fichiers de propriétés mis à jour contiennent les informations suivantes :
- Les propriétés sont copiées de la version 2 du fichier teamserver.properties.
- Des entrées de fournisseur de base de données valides (vérifiez que la base de données spécifiée dans /conf/jts/teamserver.properties existe).
Pour plus d'informations, voir Vérification des fichiers de configuration pendant la mise à niveau.
- Vérifiez que friendsconfig.rdf est copié de <rép_install_RTC2.X>/server/conf/jazz vers <rép_install_3.0.1CCM>/server/conf/jazz.
- Vérifiez que le fichier tomcat-users.xml a été copié.
- Ouvrez le fichier version 3 server.xml et vérifiez qu'il contient les informations de la version 2 (numéros de port, paramètres LDAP et autres modifications).
- Ouvrez le fichier version 3 web.xml et vérifiez qu'il contient les informations de la version 2 (paramètres LDAP et autres modifications).
- Vérifiez qu'une adresse URL publique distincte valide, com.ibm.team.repository.server.webapp.url existe dans les fichiers teamserver.properties. (l'adresse URL de l'application CCM doit être la même que celle qui a été utilisée pour Rational Team
Concert version 2.)
- Ouvrez une fenêtre de commande et accédez au répertoire <rép_install_CCM3.0>/server.
- Exécutez la commande suivante pour ajouter des tables à la base de données :
repotools-jazz -addTables
- Exécutez la commande suivante pour exporter des informations utilisateur à partir de la base de données Rational Team Concert :
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
Remarque : Si vous suivez cette procédure plusieurs fois, utilisez un nom de fichier différent pour le deuxième fichier tar. Par exemple, utilisez jtsData2.tar.
- Sur la machine où est installé Jazz Team Server, exécutez la commande suivante pour importer des informations utilisateur dans la base de données Jazz
Team Server :
Remarque : Si vous n'utilisez pas la base de données Derby par défaut, vérifiez que la base de données Jazz Team Server référencée dans le fichier
conf/jts/teamserver.properties est nouvelle et qu'elle existe.
repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
Remarque : Si vous suivez cette procédure plusieurs fois, utilisez un nom de fichier différent pour le deuxième fichier tar. Par exemple, utilisez jtsData2.tar.
Avertissement : Lorsque vous importez les données Jazz Team Server depuis la seconde installation de l'application CCM, n'utilisez pas le paramètre createTables.
Si des applications CLM sont déjà installées sur Jazz Team Server et que vous utilisez le paramètre createTables, vous perdrez les données utilisateur dans le serveur.
- Exécutez la commande suivante pour importer des informations utilisateur Jazz Team Server dans la base de données Rational Team Concert :
repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt
- Exécutez la commande suivante pour régénérer les index de texte :
repotools-jazz -rebuildTextIndices
- Exécutez la commande suivante pour régénérer les index Lucene et RDF :
repotools-jazz -reindex
- Si votre produit version 2 a un emplacement d'index qui n'est pas défini par défaut et que vous souhaitez continuer à utiliser un emplacement personnalisé pour les index, vous devez modifier le fichier teamserver.properties version 3.0.1 pour ajouter l'emplacement de l'index.
- Modifiez la valeur de com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex en l'emplacement du chemin d'accès complet de l'index de recherche. Par exemple, com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex.
- Remplacez la valeur de com.ibm.team.jfs.index.root.directory=indices par
l'emplacement de chemin complet du répertoire racine de l'index JFS. Par exemple, com.ibm.team.jfs.index.root.directory=c:/indices.
- Vérifiez les éléments suivants :
- Vérifiez que l'emplacement de la base de données Jazz Team Server est différent de l'emplacement de la base de données d'application.
- Assurez-vous que l'index ou les autres propriétés liées aux fichiers ne sont pas partagées entre les applications et Jazz Team Server.
- Assurez-vous que le fichier friendconfig.rdf est renommé friendconfig.rdf.saved.
- Si vous utilisez Apache Tomcat, reportez-vous à Configuration d'Apache Tomcat.
- Si vous utilisez WebSphere Application Server, désinstallez vos
applications Web déjà installées et redéployez les fichiers jts.war, ccm.war
et clmhelp.war fournis avec l'installation 3.0.1.
Pour plus de détails, voir Configuration de WebSphere Application Server pour la mise à niveau de la version 3.
- Configurez le serveur et les applications CLM que vous avez installées.
Exécutez l'assistant de configuration du serveur si vous effectuez une mise à niveau de Jazz Team Server en même temps que
l'application Gestion des modifications et de la configuration ou que l'une des applications CLM (voir Exécution de l'assistant de configuration) Utilisez l'interface Web d'administration si vous ajoutez l'application Gestion des modifications et de la configuration
à un serveur Jazz Team Server établi. (voir Enregistrement d'applications avec Jazz Team Server.