Mise à niveau vers Rational Team Concert 2.0.0.2

Généralement, vous pouvez mettre à niveau les clients et serveurs Rational Team Concert en créant un fichier zip ou en effectuant l'installation à l'aide d'IBM Installation Manager.
Remarque : Si vous utilisez IBM Installation Manager pour installer Rational Team Concert 2.0.0.2 sur un ordinateur où Rational Team Concert n'est pas installé, Installation Manager vous invite à sélectionner les langues à installer. Cependant, si vous effectuez la mise à niveau d'une version antérieure vers la version 2.0.0.2, IBM Installation Manager suppose que vous voulez utiliser les langues actuelles et ne vous invite pas à sélectionner les langues. Pour sélectionner les langues supplémentaires, une fois que vous avez effectué la mise à niveau vers la version 2.0.0.2, sélectionnez Modifier à partir de l'écran principal d'IBM Installation Manager, puis sélectionnez les langues proposées. L'écran suivant affiche la liste des langues prises en charge. Sélectionnez les langues dont vous avez besoin.
Si vous démarrez Jazz Team Server une fois que vous avez migré vers la version 2.0.0.2 et avant de sélectionner Modifier pour ajouter ou supprimer des langues, vous devez redémarrer le serveur comme suit :
  1. Dans un navigateur Web, accédez à
    https://<server-host>:<jazz-port>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
  2. Cliquez sur Réinitialisation du serveur.
  3. Arrêtez le serveur.

Vous pouvez ensuite sélectionner Modifier dans IBM Installation Manager pour ajouter ou supprimer des langues.

Compatibilité des clients et des serveurs Rational Team Concert

Le tableau suivant indique la compatibilité des versions client Rational Team Concert avec les versions Jazz Team Server.
Tableau 1. Compatibilité des clients et des serveurs
Version du client Rational Team Concert Version Jazz Team Server compatible
1.0.x for Eclipse 0.6.x
2.0.x for Eclipse 1.0.x
2.0.0.0 for Microsoft Visual Studio 1.0.0.0
2.0.x for Microsoft Visual Studio 1.0.x

Mise à niveau d'un client Rational Team Concert pour Eclipse IDE

Si vous disposez des versions 1.0, 1.0.1, ou 1.0.1.1 du client pour Eclipse IDE, vous devez vous procurer le client 2.0.x pour vous connecter à votre nouveau serveur version 2.0.x. Vous pouvez l'installer à l'aide d'un fichier zip, ou mettre à niveau votre précédente installation d'IBM® Installation Manager.

Installation d'un client Rational Team Concert pour Microsoft Visual Studio IDE

Si vous disposez de la version 1.0.1.1 du client pour Microsoft® Visual Studio IDE, vous devez vous procurer le client 2.0.x pour vous connecter à votre nouveau serveur version 2.0.x.
A faire : Aucun fichier .zip n'est fourni pour le client pour Microsoft Visual Studio. Pour installer la version 2.0.x ou y migrer, vous devez utiliser IBM Installation Manager.

La mise à niveau d'un serveur à partir d'une version Trial ou Early Access permet d'obtenir une version permanente

Si vous exécutez une version Early Access de Rational Team Concert, effectuez d'abord une mise à niveau vers la version Trial 2.0.0.2.

A partir de la version Trial 2.0.0.2, vous pouvez rendre votre serveur permanent en achetant puis en installant le Server Activation Kit pour votre édition, disponible à l'adresse suivante : http://www.ibm.com/software/awdtools/rtc/. Le kit d'activation est constitué d'un fichier JAR contenant la clé de licence serveur permanente. Il est installé à l'aide de la page Gestion de clé de licence de l'interface Web d'administration de votre serveur.

Mise à niveau d'un serveur 1.0, 1.0.1, 1.0.1.1 ou 2.0

Vous pouvez directement effectuer la mise à niveau vers la version 2.0.0.2 de Rational Team Concert à partir des versions précédentes. Une migration de base de données est requise pour les mises à jour 1.x à 2.x. Pour plus d'informations sur la migration d'une base de données, voir Migration du référentiel Jazz après la mise à niveau de Jazz Team Server.

Remarque : Avant de commencer la mise à niveau de WebSphere Application Server, réinitialisez le serveur en accédant à https://{servername}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset et en cliquant sur Réinitialisation du serveur.

Si vous avez installé la version précédente à partir d'un fichier zip, il n'y a pas d'interférence avec l'installation précédente. Vous pouvez installer la version 2.0.0.2 à partir d'un fichier zip à un nouvel emplacement ou utiliser IBM Installation Manager pour installer une instance 2.0.0.2.

Si vous avez utilisé IBM Installation Manager pour installer la version précédente, vous pouvez installer la version 2.0.0.2 comme instance distincte ou mettre à jour l'instance vers la version 2.0.0.2. Si vous installez une instance séparée du serveur pour la version 2.0.0.2, sélectionnez Créer un groupe de packages sur la page Installation de packages de l'assistant d'installation.

Remarque : Pour mettre à niveau un déploiement de WebSphere Application Server de Jazz Team Server, supprimez le fichier jazz.war précédent et déployez le fichier jazz.war 2.0.0.2.

Pour terminer la mise à niveau, voir Copie des fichiers de configuration requis à partir d'une installation de serveur précédente et Installation des clés d'activation 2.0.0.2.

Mise à niveau d'un serveur d'une édition de Rational Team Concert vers une autre

Vous pouvez effectuer une mise à niveau entre différentes éditions Rational Team Concert. Il s'agit généralement de mises à niveau pour passer de l'édition Express-C à Express, ou Express à Standard. Vous pouvez également rétromigrer vers une édition précédente en suivant le même processus.

Etant donné que toutes les éditions Rational Team Concert 2.0.0.2 prennent en charge les bases de données Derby, il n'est pas utile de migrer de Derby vers DB2 ou Oracle si vous passez de l'édition Express-C à Express ou Standard. Il est recommandé de commencer par mettre à niveau votre édition serveur, en s'assurant que tout fonctionne correctement avec la base de données existante, puis de migrer la base de données si nécessaire. Notez que la base de données Derby ne prend en charge que 10 utilisateurs. Pour plus d'informations sur la migration d'une base de données, voir Migration du référentiel Jazz après la mise à niveau de Jazz Team Server .

Si vous avez installé une édition Rational Team Concert 2.0.0.2 et que vous souhaitez la mettre à niveau, téléchargez et installez la nouvelle édition, avec l'édition existante, puis copiez les fichiers de configuration requis pour exécuter la nouvelle édition. La section suivante décrit les fichiers de configuration requis.

Si vous avez installé votre édition précédente à partir d'un fichier zip, il n'y a pas d'interférence avec l'installation précédente. Vous pouvez installer la nouvelle édition à partir d'un fichier zip à un nouvel emplacement, ou utiliser IBM Installation Manager pour installer une nouvelle édition. Il est recommandé d'utiliser IBM Installation Manager pour des serveurs de production pour permettre des mises à niveau ultérieures.

Si vous avez utilisé IBM Installation Manager pour effectuer votre installation de serveur précédente, et que vous souhaitez utiliser IBM Installation Manager pour installer votre nouvelle édition, n'écrasez pas l'édition précédente lors de l'installation avec Installation Manager. Sur la page Installation de packages de l'assistant d'installation, sélectionnez Créer un groupe de packages.

Cette opération permet d'installer la nouvelle édition à un emplacement différent et de créer des raccourcis programme utilisant le nom du nouveau groupe de packages.

Si vous n'effectuez pas cette opération, l'installation échoue et il en résulte un conflit de fichiers. Tel est le cas lorsqu'une fenêtre d'erreur intitulée Installation Failed apparaît, avec les détails suivants :
Installation failed.
  Error during "install" phase:
    Failed to extract zip standard 1.0.1.I20081018-1820.  File
    D:\JazzTeamServer\server\license-update-site\site.xml already exists.

Si cela se produit, ce n'est pas fatal ; vous pouvez redémarrer l'installation et créer correctement un nouveau groupe de packages.

Mises à jour de la configuration de WebSphere Application Server

Les étapes ci-après sont requises pour configurer correctement WebSphere Application Server dans Rational Team Concert 2.0.0.2.
  1. Vérifiez que les groupes de correctifs les plus récents de WAS et WASDK sont installés. Si vous effectuez un déploiement dans WAS 7.0, il est important qu'au moins WebSphere Application Server 7.0.0.3 soit installé.
  2. Supprimez les anciennes propriétés personnalisées de la machine JVM :
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Ajoutez la nouvelle propriété JVM personnalisée JAZZ_HOME et affectez-lui la valeur suivante :
    file:///<JazzInstallDir>/server/conf
  4. Vérifiez que le paramètre de sécurité WAS "Utiliser les données d'authentification disponibles quand un URI non protégé est accédé" est coché. Si vous utilisez WAS Integrated Solutions Console, vous pouvez procéder comme suit :
    1. Accédez à Sécurité -> Administration, applications et infrastructure sécurisées -> Sécurité Web - Paramètres généraux.
    2. Cochez la case "Utiliser les données d'authentification disponibles quand un URI non protégé est accédé".

Copie des fichiers de configuration requis à partir d'une installation de serveur précédente

Copiez les fichiers suivants à partir du serveur source vers le serveur cible. Pour commencer, renommez les fichiers originaux dans l'installation sur le serveur mis à niveau pour créer des sauvegardes. Si vous avez utilisé IBM Installation Manager pour mettre à jour la version 1.0, 1.0.1, 1.0.1.1 ou 2.0 vers la version 2.0.0.2, un répertoire de sauvegarde contenant les fichiers de configuration 1.0.x ou 2.0 a été créé, sous un nom tel que backup-config-horodatage dans le sous-répertoire du serveur de l'emplacement de l'installation.

Si vous effectuez une mise à niveau vers l'édition Standard ou Enterprise, et que vous avez acheté le Developer Client Activation Kit pour l'édition Express, achetez et installez le Developer Client Activation Kit pour l'édition Standard ou Enterprise, pour pouvoir utiliser ces licences client. Vos affectations de la licence Developer sont toujours valables, mais les licences Developer seront désactivées jusqu'à ce que le bon kit d'installation soit installé.

Installation des clés d'activation 2.0.0.2

La version 2.0.0.2 utilise les clés d'activation 2.0.0.2. Si un serveur est migré de la version 1.0.x.x vers la version 2.0.x, il repasse à une licence provisoire après la mise à niveau et vous devez vous procurer les clés d'activation 2.0 ou 2.0.0.2 auprès d'IBM Rational License Key Center.

Pour plus d'informations sur IBM Rational License Key Center, voir le site IBM Rational Licensing Support et l'astuce technique associée jazz.net Tech Tip.

Ci-dessous, les noms des clés appropriées à chaque kit :

  • IBM Rational Team Concert Express Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Standard Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Enterprise Edition Server Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBMRational Team Concert Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Express Edition Developer Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Contributor Client Access Activation Kit V2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Developer Client Access Activation Kit V2.0, 2.0.0.2

Définition d'une chronologie

Dans Rational Team Concert 1.x, les projets pouvaient posséder plusieurs chronologies (précédemment appelées "lignes de développement") et toutes ces chronologies étaient considérées comme égales.

Dans Rational Team Concert 2.0, les projets peuvent toujours posséder plusieurs chronologies, mais l'une d'elles peut être marquée comme "chronologie du projet". Lorsque vous migrez votre base de données vers la version 2.0, la chronologie principale du projet n'étant pas connue, aucune chronologie de projet n'est définie pour vos projets. Vous pouvez mettre à jour manuellement vos projets pour définir la chronologie de projet, une fois que vous avez migré vers la version 2.0

Configuration de l'instantané Source Control Management

L'instantané SCM (Source Control Management) de l'entrepôt de données collecte les données sur les flux et notamment les informations sur la taille de ses flux et de son activité (ensembles d'artefacts modifiés et modifications de fichier/dossier). Dans la version 1.0, cet instantané collectait automatiquement des informations sur tous les flux. Cette opération pouvant s'avérer coûteuse, dans la version 2.0, les options de possibilité de configuration sont ajoutées à l'instantané SCM pour laisser les utilisateurs décider des flux dont les données doivent être collectées. Par conséquent, à moins que vous ne le configuriez, les données ne seront pas collectées.

Pour configurer l'instantané SCM, procédez comme suit :
  1. Vous devez disposer des droits d'écriture sur le flux dont vous souhaitez collecter les données.
  2. Accédez à la page Rapports dans l'interface graphique Web.
  3. Dans le panneau de navigation de gauche, sélectionnez Administrer l'image instantanée SCM. Une liste de flux s'affiche.
  4. Cochez les cases d'un ou plusieurs flux, puis sélectionnez Sauvegarder les modifications.

Les données des flux sélectionnés seront collectées dans tous les instantanés ultérieurs.

Modifications incompatibles apportées aux rapports BIRT

Si vous avez utilisé le concepteur de rapport BIRT pour créer vos propres modèles de rapport, vous pouvez rencontrer un ou plusieurs incidents lorsque vous essayez d'utiliser ces rapports dans la version 2.0. Notez bien les points suivants :
  • Modifications de l'ordre dans lequel les classes Java et JavaScript sont résolues. Si vous avez écrit dans votre rapport BIRT du code JavaScript qui utilise l'instruction importPackage() pour importer le package java.lang, sachez que les références non qualifiées à un objet du code, qui faisaient référence à la classe Java, peuvent maintenant faire référence à la classe JavaScript (et ne fonctionneront donc pas correctement). Les autres classes qui portent le même nom dans JavaScript et Java, telles que java.util.Date, peuvent rencontrer le même problème. Vous devez donc qualifier intégralement votre référence à la classe Java et supprimer l'instruction importPackage().
  • Modifications apportées au traitement des fichiers. Auparavant, le simple fait d'associer un élément (tel qu'un libellé) à un fichier, entraînait le traitement intégral de ce fichier lorsque l'élément était affiché. Cela était pratique car il était ainsi possible d'appliquer un classement au traitement des fichiers à l'aide de libellés (masqués) associés aux fichiers selon leur ordre de traitement. Désormais, une telle association ne traite que la première ligne du fichier. Pour retrouver le comportement précédent, utilisez un élément de texte dynamique et appelez un code JavaScript qui force le traitement de l'intégralité du fichier. Vous pouvez par exemple utiliser Total.count().
  • Les bogues du concepteur de rapport BIRT peuvent être à l'origine d'une perte de données. Ces incidents apparaissent lorsque vous ouvrez un fichier de conception de rapport BIRT créé dans BIRT 2.2.2 (RTC 1.0) avec le concepteur de rapport BIRT 2.3.2 (RTC 2.0). Les incidents suivants ont été observés :
    • Lors de l'édition d'un fichier pour la première fois à l'aide de BIRT 2.3.2, dans la page "Paramètres", la zone "Valeur par défaut" et celle des paramètres du rapport risquent d'être perdues. La solution consiste à ressaisir les valeurs ou à copier, puis coller les valeurs d'une version précédente de l'éditeur. Une fois que vous avez sauvegardé le fichier avec les nouvelles valeurs entrées, l'incident ne se reproduit plus.
    • Lors de l'édition d'un fichier de conception de rapport pour la première fois à l'aide de BIRT 2.3.2, la valeur par défaut des paramètres de rapport risque d'être perdue. Cela peut également se produire après l'incident décrit précédemment. La solution consiste à ressaisir les valeurs ou à copier, puis coller les valeurs d'une version précédente de l'éditeur. Une fois que vous avez sauvegardé le fichier avec les nouvelles valeurs entrées, l'incident ne se reproduit plus.

    Ces incidents peuvent être assez graves s'ils ne sont pas détectés car les données collectées par le rapport risque d'être incorrectes. Il est recommandé de vérifier chaque fichier et chaque paramètre de rapport lors de l'édition d'un rapport pour la première fois à l'aide du concepteur de rapport de BIRT 2.3.2. Ces incidents ne se produisent pas pour les nouveaux rapports créés à l'aide des outils de BIRT 2.3.2.

    Les modifications ci-dessus sont apportées à tous les rapports Rational Team Concert 2.0 prêts à l'emploi ; aucune intervention n'est requise de votre part. Toutefois, si vous avez créé des modèles de rapport manuellement dans votre zone de projet à l'aide de nos rapports prêts à l'emploi et que vous n'avez pas spécifié d'identificateur approprié (qui respecte notre syntaxe), votre modèle de rapport ne sera pas régénéré lors de sa migration. Le contenu sera donc obsolète et ne fonctionnera pas. Dans ce cas, vous devez télécharger le nouveau contenu des modèles affectés, à l'aide du fichier .rptdesign prêt à l'emploi approprié.

Importation des données des éléments de travail dans l'entrepôt de données

Dans Rational Team Concert 2.0, plusieurs modifications de schéma ont été apportées aux tables des éléments de travail de l'entrepôt de données. En conséquence, lors de la migration de la version 1.0 vers la version 2.0, l'importateur ignore les données des éléments de travail entreposés. Par conséquent, lorsque vous démarrez le serveur 2.0 pour la première fois, vos rapports d'éléments de travail risquent de ne pas fonctionner correctement. La solution consiste à attendre que l'instantané des éléments de travail soit exécuté pour la première fois ou à l'exécuter manuellement après le démarrage du serveur. Lors de la première exécution après la migration, l'instantané des éléments de travail reconstitue l'intégralité des informations historiques sur les éléments de travail dans l'entrepôt de données. Cela signifie également que la première exécution de l'instantané après la migration risque de durer bien plus qu'une exécution nocturne standard.

Détection des nouveaux rapports

Dans Rational Team Concert 2.0, plusieurs rapports ont été ajoutés. Ces rapports apparaissent dans les nouveaux modèles de processus livrés avec le produit, mais ils ne sont pas automatiquement ajoutés aux zones de projet existantes lors de la migration. Nous avons ajouté une nouvelle action qui vous permettra de détecter et déployer ces nouveaux modèles de rapport dans vos zones de projet existantes après la migration. Pour déployer les nouveaux modèles de rapport, procédez comme suit :
  1. Sur le client enrichi, ouvrez la vue Artefacts de l'équipe.
  2. Développez votre zone de projet et Rapports.
  3. A l'aide du bouton droit de la souris, cliquez sur Modèles de rapport et sélectionnez Déployer de nouveaux modèles.

La boîte de dialogue permet de détecter les modèles de rapport qui sont disponibles, mais qui ne sont pas encore déployés dans votre zone de projet. Vous pouvez en sélectionner un ou plusieurs, qui seront créés. Une fois que ces modèles ont été créés, vous pouvez créer des rapports à partir de ces modèles à l'aide des actions de menu disponibles.

Personnalisations

Les modifications que vous apportez aux types d'élément de travail, attributs, flux de travaux, rôles et gestionnaires d'événements sont conservées lorsque vous migrez de la version 1.x vers la version 2.0. Si vous avez personnalisé un modèle de processus prédéfini (tel que Scrum), sachez que si vous redéployez le modèle prédéfini (dans la vue Modèles de processus), vous écrasez vos personnalisations. Si vous devez redéployer le modèle prédéfini, vous devez d'abord modifier le nom et l'ID du modèle prédéfini que vous avez personnalisé pour qu'il ne soit pas écrasé.


Commentaire

Etes-vous satisfait ? Envoyez vos commentaires sur Jazz.net (inscription requise) : Entrez vos remarques dans les forums ou soumettez un incident