Cette rubrique décrit les étapes nécessaires pour mettre à niveau Jazz Team Server et Gestion des modifications et de la configuration
de la
version 3.0 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 et Jazz Team Server version 3.0.
Vérifiez également que les horloges
de toutes les machines 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 comptez mettre à niveau plusieurs produits, reportez-vous à la rubrique Ordre de mise à niveau pour vous aider à décider par lequel commencer.
Important : Pour pouvoir utiliser le script de mise à niveau dans un environnement distribué où vous installez l'application Gestion de la qualité séparément de Jazz Team Server,
le script de mise à niveau doit pouvoir accéder à l'unité ou au système de fichiers sur lequel Jazz
Team Server est installé. Sous Windows, par exemple, le mappage doit suivre la forme <lettre de l'unité mappée>:\server\conf.
Un chemin d'accès absolu (\\<nom_machine>\<rép_install>server\conf) ne fonctionnera pas. L'unité montée doit être configurée avec les droits de lecture, écriture et exécution pour le compte admin.
Si vous utilisez la base de données
Derby, copiez les bases de données JTS et CCM de la version 3.0 vers la version
3.0.1. Pour plus d'informations, voir
Sauvegarde et restauration de la base de données Derby.
Remarque : Si vous utilisez la même base de données, la migration des données n'est pas requise. Mais si vous basculez vers une autre base de données lors de la mise à niveau, vous devez exporter les données depuis l'ancienne et les importer dans la nouvelle.
Mise à niveau de Jazz Team Server (JTS)
- Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
- Arrêtez le serveur 3.0 JTS.
- Si vous n'avez pas encore installé Jazz Team Server dans le cadre d'une installation CLM, installez Jazz Team Server dans un nouvel emplacement sur le disque. Si vous avez déjà installé Jazz Team Server et mis à niveau vers la version 3.0.1 et si vous souhaitez installer et mettre à niveau l'application Gestion des modifications et de la configuration and Configuration
Management, passez à Mise à niveau de la gestion des modifications et de la Configuration (CCM).
- Lors de l'installation, sélectionnez Utiliser les racines de contexte de l'application 3.x par défaut.
- A la fin de l'installation, sélectionnez Aucun
lorsque le système vous demande quel programme vous
souhaitez démarrer.
- Accédez à <rép_install_3.0.1JTS>/server et exécutez la commande suivante :
Remarque : Vous pouvez exécuter le script en spécifiant tous les arguments dans la ligne de commande. Vous pouvez aussi, si vous allez exécuter plusieurs fois le script de mise à niveau, éditer le fichier des paramètres du script et exécuter une ligne de commande concise.
Reportez-vous à l'étape suivante pour consulter les instructions pour le fichier de paramètres.
Important : Bien que le fichier de script soit situé sous le répertoire de mise à niveau, il doit être exécuté depuis le répertoire du serveur . De plus, si votre chemin d'accès comporte des espaces, prenez soin de l'encadrer avec des guillemets.
Windows
upgrade\jts_upgrade.bat -oldJTSHome <rép_install_3.0JTS>\server\conf
UNIX
upgrade/jts_upgrade.sh -oldJTSHome <rép_install_3.0JTS>/server/conf
Si vous avez besoin de plus d'informations sur les options de ligne de commande, voir jts_upgrade.
Le script exécute les tâches suivantes avec les interactions d'utilisateur indiquées :
- Facultatif : A la place de l'étape précédente, vous pouvez ouvrir le fichier des paramètres du script, modifier les valeurs par défaut et exécuter une forme abrégée de la ligne de commande.
Les versions anglaises et traduites des fichiers jts_params se trouvent dans le répertoire <rép_install_3.0.1JTS>/server/upgrade/params.
- Pour déterminer le nom exact du fichier de paramètres pour votre langue, exécutez depuis le répertoire <rép_install_3.0.1JTS>\server\upgrade la commande locale.bat -jts -showParamFileName sous Windows
ou locale.sh -jts -showParamFileName sur les systèmes UNIX.
- Ouvrez le fichier jts_params ou sa version traduite pour modifier ou spécifier des valeurs pour chaque paramètre. L'un des paramètres devant être définis est le chemin d'accès au répertoire
OLD_JTS_HOME.
- 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
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.
- Démarrez le serveur JTS.
- Continuez avec Exécution de l'assistant de configuration pour configurer le serveur.
Mise à niveau de la gestion des modifications et de la Configuration (CCM)
- Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
- Arrêtez le serveur CCM 3.0.
- Installez l'application CCM dans un nouvel emplacement sur le disque.
- Lors de l'installation, sélectionnez Utiliser les racines de contexte de l'application 3.x par défaut.
Important : Si Rational Team Concert version 3.0 a été mis à niveau
à partir d'une version 2, sélectionnez Utiliser la racine de
contexte de Rational Team Concert 2.x pour conserver la racine de
contexte /jazz.
- A la fin de l'installation, sélectionnez Aucun
lorsque le système vous demande quel programme vous
souhaitez démarrer.
- Accédez à <rép_install_3.0.1CCM>/server et exécutez la commande suivante :
Remarque : Vous pouvez exécuter le script en spécifiant tous les arguments dans la ligne de commande. Vous pouvez aussi, si vous allez exécuter plusieurs fois le script de mise à niveau, éditer le fichier des paramètres du script et exécuter une ligne de commande concise.
Reportez-vous à l'étape suivante pour consulter les instructions pour le fichier de paramètres.
Important : Bien que le fichier de script soit situé sous le répertoire de mise à niveau, il doit être exécuté depuis le répertoire du serveur . De plus, si votre chemin d'accès comporte des espaces, prenez soin de l'encadrer avec des guillemets.
En outre, veillez à indiquer le paramètre applicationContextRoot et à le définir par ccm. Par défaut, applicationContextRoot est jazz.
Windows
upgrade\ccm_upgrade.bat -oldApplicationHome <rép_install_CCM3.0>\server\conf -applicationContextRoot ccm
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <rép_install_CCM3.0>/server/conf -applicationContextRoot ccm
Si vous avez besoin de plus d'informations sur les options de ligne de commande, voir ccm_upgrade.
Le script exécute les tâches suivantes avec les interactions d'utilisateur indiquées :
- Exécute la commande -migration_ccm_updateConfigurationFiles et met à jour les fichiers Tomcat et de configuration. Entrez [E] pour exécuter la commande, [S] pour ignorer cette étape ou appuyez sur la touche [Entrée] pour annuler l'exécution du script.
- Une fois que la fusion des fichiers de configuration a réussi, entrez [C] pour continuer. La fenêtre Bloc-notes (ou un éditeur vi sur les systèmes Unix) qui apparaît vous permet de vérifier le fichier teamserver.properties CCM.
Vérifiez que la racine d'URI public indiquée par la propriété com.ibm.team.repository.server.webapp.url est correcte. Vérifiez également que les propriétés de base de données sont correctes. L'emplacement de la base de données doit être différent de celui de la base de données JTS. Lorsque vous avez terminé, sauvegardez vos modifications, si nécessaire, et fermez l'éditeur pour continuer à exécuter le script. Pour plus d'informations sur la vérification des fichiers de configuration, voir Vérification des fichiers de configuration pendant la mise à niveau.
- Poursuivez à exécuter le script jusqu'à ce qu'apparaisse un message indiquant que la mise à niveau CCM a réussi.
- Facultatif : A la place de l'étape précédente, vous pouvez ouvrir le fichier des paramètres du script, modifier les valeurs par défaut et exécuter une forme abrégée de la ligne de commande.
Les versions anglaises et traduites des fichiers ccm_params se trouvent dans le répertoire <rép_install_3.0.1CCM>/server/upgrade/params.
- Pour déterminer le nom exact du fichier de paramètres pour votre langue, exécutez depuis le répertoire <rép_install_3.0.1CCM>\server\upgrade la commande locale.bat -ccm -showParamFileName sous Windows
ou locale.sh -ccm -showParamFileName sur les systèmes UNIX.
- Ouvrez le fichier ccm_params ou sa version traduite pour modifier et spécifier des valeurs pour chaque paramètre. L'un des paramètres devant être définis est le chemin d'accès au répertoire
OLD_APPLICATION_HOME. Vérifiez que ce chemin ne comporte pas d'espaces.
- Si vous utilisez Apache Tomcat, reportez-vous à Configuration d'Apache Tomcat.
- Si vous utilisez IBM WebSphere Application Server, désinstallez vos
applications Web déjà installées et redéployez le fichier ccm.war fourni 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.
- Démarrez le serveur CCM.
- 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.