Installation du client Rational Team Concert à l'aide d' IBM Installation Manager


Cette version a été générée le 10 Juin 2009.

La dernière version de cette procédure d'installation, ainsi que les informations utiles de planification sont disponibles à l'adresse suivante : http://publib.boulder.ibm.com/infocenter/rtc/v2r0m0/index.jsp.

Table des matières

Installation du client à l'aide d'IBM Installation Manager
Mise à niveau vers Rational Team Concert 2.0
Installation de Rational Team Concert avec Security-Enhanced Linux

Installation du client à l'aide d'IBM Installation Manager

Le client est réparti en tant que fichier téléchargeable par l'intermédiaire d'IBM Installation Manager.

A propos de cette tâche

Remarque :
Si vous souhaitez installer le client dans un plan de travail Eclipse existant, utilisez IBM Installation Manager. IBM Installation Manager vous invite à choisir le plan de travail que vous souhaitez étendre et à gérer les futures mises à jour, annulations et modifications du plan de travail
Remarque :
Si la fonction SELinux (Security-Enhanced Linux) est active, vous devez la désactiver ou modifier le contexte de sécurité de JRE (Runtime Environment)pour permettre le déplacement de texte afin d'installer et d'exécuter Rational Team Concert. Pour plus d'informations, voir Installation de Rational Team Concert avec Security-Enhanced Linux.

  1. Téléchargez l'un des modules d'installation ci-dessous.

    Il existe trois méthodes d'installation du client Rational Team Concert.

  2. Démarrez le programme de tableau de bord.

    Si Installation Manager ne fonctionne pas, procédez comme suit pour le démarrer.

    Remarque :
    Vous devez détenir les droits d'administrateur pour exécuter le tableau de bord.
    Remarque :
    Les commandes Linux pour démarrer le programme de tableau de bord ne sont valables que pour Rational Team Concert pour Eclipse IDE.
    Pour démarrer le fichier du tableau de bord sur :
  3. Vous pouvez installer les clients suivants : L'assistant d'Installation Manager s'affiche. L'assistant vous accompagne tout au long de l'installation du client.
  4. Démarrez le client en cliquant sur le raccourci Rational Team Concert créé par l'installation.
  5. Connectez-vous au serveur. Le moyen le plus facile de se connecter à un serveur consiste à utiliser une invitation d'équipe. Si vous ne disposez d'aucune invitation, vous pouvez vous connecter manuellement.
    1. Cliquez sur Fichier -> Accepter une invitation d'équipe. L'assistant vous accompagne tout au long du processus.
      Remarque :
      Si vous ne disposez d'aucune invitation, vous avez besoin de l'URI ou de l'URL de l'administrateur de serveur. (https://example.com:9443/jazz, par exemple). Cliquez sur le lien hypertexte de connexion à une zone de projet existante qui apparaît dans le coin inférieur droit de la fenêtre Accepter une invitation d'équipe.
    2. Suivez les instructions de l'assistant pour configurer votre connexion.

Exemple

Identification et résolution des incidents : ici vous sont proposées quelques techniques de gestion des incidents.

Que faire ensuite

A l'issue de l'installation du client, consultez les rubriques suivantes pour vous initier à Rational Team Concert.

Mise à niveau vers Rational Team Concert 2.0

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 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, 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, 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 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:9443/jazz/admin.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.

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

Si vous disposez de versions 1.0, 1.0.1 ou 1.0.1.1 du client pour Eclipse IDE, vous devez vous procurer le client 2.0 pour vous connecter à votre nouveau serveur version 2.0. 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 pour vous connecter à votre nouveau serveur version 2.0.

A faire :
Aucun fichier .zip n'est fourni pour le client pour Microsoft Visual Studio. Pour installer la version 2.0 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.

A partir de la version Trial 2.0, 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 ou 1.0.1.1

Vous pouvez directement effectuer la mise à niveau vers la version 2.0 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.

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 à partir d'un fichier zip à un nouvel emplacement ou utiliser IBM Installation Manager pour installer une instance 2.0.

Si vous avez utilisé IBM Installation Manager pour installer la version précédente, vous pouvez installer la version 2.0 comme instance distincte ou mettre à jour l'instance vers la version 2.0. Si vous installez une instance séparée du serveur pour la version 2.0, 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 WebSphere Application Server de Jazz Team Server, supprimez le fichier jazz.war précédent et déployez le fichier jazz.war 2.0.

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.

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 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. Pour plus d'informations concernant 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 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.

  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 ou 1.0.1.1 vers la version 2.0, un répertoire de sauvegarde contenant les fichiers de configuration 1.0.x 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

La version 2.0 utilise les clés d'activation 2.0. Si un serveur est migré de la version 1.0.x.x vers la version 2.0, il repasse à une licence provisoire après la mise à niveau et vous devez vous procurer les clés d'activation 2.0 auprès de Passport Advantage. Ci-dessous, les noms des clés appropriées à chaque kit :

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é du contrôle des sources

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 :

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é.

Installation de Rational Team Concert avec Security-Enhanced Linux

Si SELinux (Security-Enhanced Linux) est activé, vous devez le désactiver et modifiez le contexte de sécurité des JRE (Java Runtime Environments) utilisés pour installer et exécuter Rational Team Concert pour permettre le transfert texte.

A propos de cette tâche

Si vous avez configuré une machine avec pour seul objectif d'évaluer les fonctions Rational Team Concert et SELinux dont vous n'avez pas réellement besoin, le moyen le plus facile consiste à désactiver SELinux.

Remarque :