Installation d'IBM Rational Team Concert Express Edition à l'aide d' IBM Installation Manager


Cette version a été générée le 09 Fév 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/v1r0m1/index.jsp.

Table des matières

Installation de Rational Team Concert Express Edition
Mise à niveau vers Rational Team Concert 1.0.1 ou 1.0.1.1
Installation d'Express Edition - Présentation
Préparation de l'installation d'Express Edition
Instructions particulières pour Linux
Installation d'Express Edition à partir d'IBM Installation Manager
Configuration de la base de données
Configuration d'une base de données DB2
Configuration d'une base de données Oracle
Configuration d'une base de données de serveur SQL
Création des tables de base de données de Jazz Team Server
Démarrage du serveur
Démarrage du serveur Apache Tomcat
Démarrage du serveur sous Windows
Démarrage du serveur sous Linux
Configuration d'un WebSphere Application Server
Exécution de l'assistant de configuration
Procédure d'installation
Installation du client à l'aide d'IBM Installation Manager
Installation de l'Build System Toolkit à partir d'IBM Installation Manager
Installation de Rational Team Concert avec Security-Enhanced Linux

Installation de Rational Team Concert Express Edition

Mise à niveau vers Rational Team Concert 1.0.1 ou 1.0.1.1

Vous pouvez mettre à niveau les clients et serveurs Rational Team Concert soit en créant un fichier zip, ou effectuant l'installation à l'aide d'Install Manager.

Remarque :
Si vous utilisez Installation Manager pour installer Rational Team Concert 1.0.1.1 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 1.0.1.1, Installation Manager suppose que vous voulez utiliser les langues actuelles et ne vous invite pas à sélectionner les langues. Les versions antérieures à la version 1.0.1.1 ne sont disponibles qu'en anglais. Pour sélectionner les langues supplémentaires, une fois que vous avez effectué la mise à niveau vers la version 1.0.1.1, sélectionnez Modifier à partir de l'écran principal d'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.

Mise à niveau des clients Eclipse Rational Team Concert 1.0

Si vous avez des clients 1.0, il est recommandé de disposer du client 1.0.1 ou 1.0.1.1 pour vous connecter à votre nouveau serveur 1.0.1 ou 1.0.1.1. Vous pouvez les installer à l'aide d'un fichier zip, ou mettre à niveau votre précédente installation d' 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 1.0, ou directement vers le nouveau serveur 1.0.1. Les clés de licence serveur 1.0 ne rendent pas un serveur Early Access permanent.

A partir de la version Trial 1.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-306.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

Vous pouvez directement effectuer la mise à niveau vers la version 1.0.1 ou 1.0.1.1 de Rational Team Concert à partir de la version 1.0. Vous pouvez réutiliser votre base de données 1.0 ; aucune migration de base de données n'est requise.

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 Request Server Reset (Demande de réinitialisation du serveur).

Si vous exécutez un jalon antérieur ou Beta, suivez les instructions de mise à niveau pour 1.0 https://jazz.net/downloads/rational-team-concert/releases/. Pour commencer, effectuez toute migration de base de données nécessaire.

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

Si vous avez utilisé Installation Manager pour installer la version 1.0, vous pouvez soit installer la version 1.0.1 ou 1.0.1.1 en tant qu'instance séparée, ou mettre à niveau l'instance 1.0 vers la version 1.0.1 ou 1.0.1.1. Si vous installez une instance séparée du serveur pour la version 1.0.1 ou 1.0.1.1, sélectionnez Create a new package group sur la page Install Packages de l'assistant d'installation.

Remarque :
Pour mettre à niveau un Websphere Application Server, supprimez le fichier jazz.war 1.0 et déployez le fichier jazz.war 1.0.1.

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

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

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 1.0.1 et 1.0.1.1 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 de Jazz Team Server.

Si vous avez installé une édition Rational Team Concert 1.0.1 ou 1.0.1.1 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 Installation Manager pour installer une nouvelle édition. Il est recommandé d'utiliser Installation Manager pour des serveurs de production pour permettre des mises à niveau ultérieures.

Si vous avez utilisé Installation Manager pour effectuer votre installation de serveur précédente, et que vous souhaitez utiliser 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 group 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.

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é Installation Manager pour mettre à niveau la version 1.0 vers 1.0.1, un répertoire de sauvegarde contenant les fichiers de configuration 1.0 a été créé, intitulé par exemple backup-config-timestamp dans le sous-répertoire du serveur de l'emplacement de l'installation.

Si vous effectuez une mise à niveau vers l'édition Standard, 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, pour pouvoir utiliser ces licences clients. 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 1.0.1

Si vous aviez installé la clé d'activation de serveur et Client Activation Licence Keys permanentes sur l'installation de serveur 1.0, récupérez et installez les versions 1.0.1 de ces clés. Le serveur revient à une licence provisoire une fois la mise à niveau vers 1.0.1 effectuée. Procurez-vous la clé d'activation 1.0.1 à partir Passport Advantage. Ci-dessous, les noms des clés appropriées à chaque édition de serveur :

Clés pour l'édition Express :

Clés pour l'édition Standard :

Installation d'Express Edition - Présentation

Le module d'installation comprend tous les éléments dont vous avez besoin pour démarrer.

La configuration paré défaut inclut les éléments suivants :

Remarque :
Une feuille de travail facultative est disponible dans l'aide en ligne pour vous permettre de choisir votre configuration et d'enregistrer vos décisions.

Préparation de l'installation d'Express Edition

Avant d'installer le serveur, assurez-vous d'avoir respecté les considérations particulières.

Instructions particulières pour Linux

Examinez les instructions particulières suivantes lors de l'installation de Jazz Team Server sous Linux.

Installation d'Express Edition à partir d'IBM Installation Manager

Procurez-vous les fichiers d'installation, puis démarrez l'installation.

A propos de cette tâche

Jazz Team Server, le client Rational Team Concert, l'Build System Toolkit, ClearCase Connector , ClearQuest Connector et d'autres fichiers d'incubateur peuvent être téléchargés à partir de http://jazz.net. Pour vous procurer Rational Team Concert, accédez au site Web http://www.ibm.com/software/awdtools/rtc/, dans lequel vous pouvez télécharger une image installable ou commander un DVD.

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

    Il existe deux méthodes d'installation de Rational Team Concert Express Edition à l'aide d'IBM Installation Manager.

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

    Si Installation Manager ne fonctionne pas, démarrez-le.

    Remarque :
    Vous devez détenir les droits d'administrateur pour exécuter le tableau de bord.
  3. Lorsque le programme de tableau de bord démarre, une liste des éléments à installer s'affiche. Installez chaque module que vous souhaitez utiliser dans l'ordre répertorié.
    1. Installez Jazz Team Server.

      Si vous utilisez IBM Installation Manager, notez le répertoire d'installation sur la page Emplacement lors du processus d'installation. Le répertoire s'appelle JazzInstallDir.

      Remarque :
      Si vous prévoyez d'utiliser un serveur d'applications existant à la place du serveur Apache Tomcat inclus, décochez la case du module Apache Tomcat. Pour ce faire, installez uniquement les fichiers requis à utiliser avec votre serveur d'applications existant. Installation Manager vous invite à choisir l'emplacement d'installation de ces fichiers.
    2. Facultatif : installez DB2 Express.
      Remarque :
      Malgré la présence d'une base de données Derby dans la configuration par défaut ne nécessitant pas d'installation, cette base de données ne peut pas prendre en charge plus de 10 utilisateurs. Si vous souhaitez prendre en charge plus de 10 utilisateurs et n'avez accès à aucune base de données DB2 ou Oracle, installez DB2 Express

      Si vous installez DB2 Express, enregistrez l'ID utilisateur, le mot de passe et le numéro de port. Vous aurez besoin de ces informations plus tard. L'acceptation des valeurs par défaut lors de l'installation permet de simplifier la configuration de Jazz Team Server.

    3. Installez le client Rational Team Concert.
    4. Facultatif : installez l'Build System Toolkit.

Configuration de la base de données

Une fois installée la base de données, il est nécessaire de procéder à un travail de configuration.

Raccourci :
Si vous utilisez la base de données Derby incluse, aucune configuration supplémentaire n'est requise. Passez à la section Démarrage du serveur.

Les étapes de la configuration d'une base de données sont les suivantes :

  1. Création d'une base de données.
  2. Configuration des fichiers de propriétés.
  3. Création des tables de base de données.

Si vous utilisez DB2 ou DB2 Express, passez à la section Configuration d'une base de données DB2.

Si vous utilisez Oracle, passez à la section Configuration d'une base de données Oracle.

Configuration d'une base de données DB2

Configurez une base de données DB2 ou DB2 Express pour gérer Jazz Team Server.

Avant de commencer

Cette procédure suppose de respecter les conditions préalables ci-dessous. Consultez la documentation DB2 ou un administrateur de base de données DB2 pour obtenir de l'aide.

A propos de cette tâche

Pour configurer une base de données DB2, procédez comme suit :

  1. Créez la base de données dans la fenêtre de commande DB2. L'exemple de commande permet de créer une base de données appelée JAZZ. Ces commandes s'exécutent dans la fenêtre de commande DB2, laquelle peut être ouverte à partir du menu Démarrer de l'application, sous le menu des outils de ligne de commande DB2.
    Remarque :
    Pour garantir le traitement correct du contenu Unicode, le jeu de caractères de la base de données doit être UTF-8.
    Conseil :
    Si la base de données n'est pas en cours d'exécution, la commande db2start démarre DB2.
  2. Recherchez le fichier teamserver.properties dans le répertoire JazzInstallDir/server te renommez-le teamserver.derby.properties.
  3. Recherchez le fichier teamserver.db2.properties dans le répertoire JazzInstallDir/server et renommez-le teamserver.properties.
  4. Indiquez les caractéristiques de la base de données et de la connexion dans le fichier teamserver.properties.

    La spécification de la connexion par défaut permet de se connecter à une base de données DB2 qui s'exécute sur le port 50000 d'un hôte local. Sous Windows, la base de données s'appelle JAZZ, les nom d'utilisateur et mot de passe étant db2admin. Si les valeurs par défaut sont utilisées lors de la configuration de votre base de données, le fichier teamserver.properties peut être déjà configuré correctement. Dans le cas contraire, procédez aux modifications nécessaires de ces informations pour qu'elles correspondent à votre configuration.

    1. Ouvrez le fichier teamserver.properties dans un éditeur de texte.
    2. Recherchez les lignes suivantes :
      com.ibm.team.repository.db.vendor = DB2
      com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      com.ibm.team.repository.db.jdbc.password=db2admin
    3. Editez la valeur de com.ibm.team.repository.db.jdbc.location de vos serveur et base de données DB2.
      Conseil :
      Dans la fenêtre de commande DB2, exécutez la commande db2 get dbm cfg, puis recherchez la ligne contenant SVCENAME, qui indique le nom ou le numéro de port DB2. Si cette commande affiche un numéro, utilisez-le comme numéro de port (à la place de 50000 dans l'exemple ci-dessus). Si la commande renvoie une valeur nom numérique, déterminez le numéro de port qui lui a été attribuée et utilisez-le. Sous Linux, le fichier /etc/services contient la mise en correspondance entre les noms et numéros de port, et sous Windows, le fichier C:\windows\system32\drivers\etc\services contient la mise en correspondance. Pour plus d'informations, demandez à l'administrateur de base de données ou consultez la documentation de la base de données.
    4. Editez la valeur de com.ibm.team.repository.db.jdbc.location de votre nom d'utilisateur DB2.
      Remarque :
      L'utilisateur DB2 doit disposer des droits de création des tables et des espaces de table ainsi que des droits de modification de la configuration de la base de données. Les utilisateurs DB2 sont créés par le système d'exploitation.
    5. Indiquez le mot de passe de l'utilisateur dans la propriété com.ibm.team.repository.db.jdbc.password.
      Remarque :
      Ne modifiez pas le texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
    6. Le cas échéant, modifiez la propriété com.ibm.team.repository.db.db2.content.tablespace.location pour indiquer un chemin d'accès sur Jazz Team Server dans lequel ont été créés les espaces de table principaux.
      Remarque :
      Si la valeur par défaut de content_tablespace n'a pas été modifiée,l'espace de table est créé dans l'emplacement de stockage de la base de données. Sous Windows, si un nouveau chemin d'accès est indiqué, il doit l'être en utilisant une double barre oblique inversée (com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace, par exemple).

Résultats

La configuration de votre base de données est terminée. Passez à la section Création des tables de base de données de Jazz Team Server.

Configuration d'une base de données Oracle

Configurez une base de données Oracle pour travailler avec Jazz Team Server.

Avant de commencer

Cette procédure suppose de respecter les conditions préalables ci-dessous. Consultez la documentation Oracle ou un administrateur de base de données Oracle pour obtenir de l'aide.

Lors de l'exécution de Jazz Team Server sur Oracle, créez une espace de table Oracle afin d'améliorer les performances. Vous devez créer un utilisateur associé à cet espace de table.

Remarque :
Cette procédure n'est en aucun cas réalisée par le générateur de base de données à l'aide des outils de référentiel.

A propos de cette tâche

Pour configurer une base de données Oracle, procédez comme suit :

  1. Créez un espace de table. L'emplacement de l'espace de table doit être approprié à la machine et à l'unité de disque.
    Remarque :
    L'espace de table peut comporter l'une des propriétés suivantes :
    • Un nom autre que oracle_tbs
    • Un emplacement dans un autre répertoire
    • Une taille supérieure à 1 Go. Pour les installations volumineuses, vous devez allouer plus d'espace.
    L'exemple ci-dessous illustre une instruction create exécutée sur une machine Windows :
    CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    Remarque :
    Le chemin de répertoire (D:\oracle_tbs, dans cet exemple) doit exister. Il n'est pas nécessaire de créer un espace de table distinct. Vous pouvez utiliser l'espace de table USERS par défaut, mais Oracle se comporte mieux avec un espace préalablement alloué sur le disque qu'il gère.
  2. Créez un utilisateur Oracle.

    Une fois créé l'espace de table, un utilisateur Oracle spécial doit être créé pour Jazz afin d'utiliser la base de données Oracle.

    Dans cet exemple, l'utilisateur porte le nom jazzDBuser et le mot de passe (IDENTIFIED BY selon la terminologie Oracle) jazzDBpswd et existe dans l'espace de table créé dans la rubrique 1.
    CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
    Une fois créé l'utilisateur, accordez les droits du système de base de données nécessaires à l'exécution de ces actions suivantes :
  3. Recherchez le fichier teamserver.properties dans le répertoire JazzInstallDir/server te renommez-le teamserver.derby.properties.
  4. Recherchez le fichier teamserver.oracle.properties dans le répertoire JazzInstallDir/server et renommez-le teamserver.properties.
  5. Configurez le serveur
    1. Ouvrez le fichier teamserver.properties dans un éditeur de texte. Recherchez les lignes suivantes et modifiez les propriétés d'emplacement et de mot de passe de votre configuration :
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Remarque :
      Si vous utilisez Oracle Express, remplacez ORCL par XE.
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/XE
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Indiquez le mot de passe de l'utilisateur dans la propriété com.ibm.team.repository.db.jdbc.password.
      Remarque :
      Ne modifiez pas le texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
    2. Dans le même répertoire que les scripts de serveur (JazzInstallDir/server), créez un répertoire nommé oracle.
    3. Recherchez le fichier JAR du pilote JDBC d'Oracle, nommé ojdbc14.jar. L'emplacement peut varier selon le produit Oracle et le système d'exploitation. Copiez ce fichier dans le répertoire nommé oracle.
      Remarque :
      Si vous utilisez WebSphere Application Server, configurez une propriété nommée "ORACLE_JDBC", puis attribuez-lui le chemin absolu (pas l'URL) des pilotes JDBC d'Oracle. Cette tâche est décrite dans les instructions de configuration de WebSphere Application Server. Notez le chemin pour une utilisation ultérieure dans ces instructions.

Résultats

La configuration de votre base de données est terminée. Vous pouvez continuer par Création des tables de base de données de Jazz Team Server.

Configuration d'une base de données de serveur SQL

Configuration d'une base de données de serveur SQL pour travailler avec le Jazz Team Server.

Cette procédure suppose de respecter les conditions préalables ci-dessous :

Remarque :
Le nom de connexion par défaut défini dans le fichier JazzInstallDir/server/teamserver.properties pour une base de données de serveur SQL est jazzDBuser et le mot de passe par défaut est jazzDBPswd. Ces valeurs sont utilisées dans les étapes suivantes pour créer une base de données. Vous pouvez remplacer ces valeurs avec le nom d'utilisateur et le mot de passe pour votre base de données.

Configuration d'une base de données

Remarque :
Cette section décrit comment configurer la base de données du serveur SQL en utilisant l'outil de ligne de commande sqlcmd, qui est fournie avec l'installation du serveur SQL. Vous pouvez également utiliser un outil visuel, tel que SQL Server Studio Management, qui est également disponible en version Express, SQL Server Studio Management Express. Consultez la documentation du serveur SQL ou l'administrateur de base de données (DBA) du serveur SQL pour plus d'informations.

Pour configurer une base de données du serveur SQL à l'aide de l'outil de commande sqlcmd, procédez comme suit :

  1. Créez une base de données Jazz Team Server. A partir de l'outil de ligne de commande, entrez :
    CREATE DATABASE jazz 
    GO 
  2. Créez un utilisateur et un mot de passe et changez le propriétaire de la base de données Jazz Team Server. A partir de l'outil de ligne de commande, entrez :
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBPswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    GO 
  3. Changez le classement de la base de données Jazz Team Server. A partir de l'outil de ligne de commande, entrez :
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO

Configuration du serveur

Remarque :
Par défaut, le fichier teamserver.properties dans le répertoire JazzInstallDir/server n'est pas configuré pour la connexion à une base de données de serveur SQL. Toute la configuration par défaut, ainsi que les paramètres spécifiques au serveur SQL sont contenus dans le fichier teamserver.sqlserver.properties dans le même répertoire.

Pour configurer le serveur :

  1. Renommez les fichiers suivants :
    Remarque :
    Renommer le fichier d'origine teamserver.properties vous permet de restaurer le fichier à sa version de travail précédente. Par défaut, le fournisseur de base de données est derby.
  2. Editez le fichier de configuration du serveur si vous avez utilisé un nom d'utilisateur, un mot de passe ou un nom de base de données différent, si vous avez installé le serveur SQL sur une autre machine que Jazz Team Server, ou si vous utilisez un autre port que celui par défaut. Ouvrez le fichier teamserver.properties dans le répertoire JazzInstallDir/server, et changez les informations mentionnées ci-dessous en fonction de votre configuration.
    com.ibm.team.repository.db.vendor = SQLSERVER
    com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
    com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
  3. Recherchez le fichier JAR du pilote JDBC du serveur SQL nommé sqljdbc.jar. L'emplacement peut varier en fonction de l'emplacement d'installation des pilotes, comme mentionné dans la section des conditions préalables.
  4. Indiquez l'emplacement du fichier JDBC JAR pour JDBC en exécutant l'une des tâches suivantes :

La configuration de votre base de données est terminée. A présent, créez les tables de la base de données Jazz Team Server. Pour plus d'informations, voir Création des tables de base de données de Jazz Team Server.

Résolution des incidents

Si la commande repotools ne s'exécute pas, vérifiez le fichier journal nommé repotools_createTables.log, situé dans le répertoire JazzInstallDir/server.

De même, vérifiez les points suivants :

Remarque :
Le code de la base de données pour le Jazz Team Server a été conçu de manière générique et standard pour pouvoir s'exécuter sur de multiples plateformes de bases de données ; cependant, des différences entre les fournisseurs de bases de données des entreprises existent dans la syntaxe, les stratégies d'optimisation et la syntaxe de verrouillage. Le serveur a été testé sur le serveur SQL à l'aide d'une combinaison de tests et de simulations automatisés avec une charge de travail normale, et de tests de charge. La simulation avec une charge de travail normale a montré une performance acceptable. Dans certains cas, des blocages de bases de données ont été observés dans les tests simultanés automatisés ; cependant, ceux-ci ne se sont pas produits systématiquement sur différentes machines serveur.

Le serveur est conçu pour répondre à un grand nombre de requêtes simultanées. Dans certains cas exceptionnels, des blocages peuvent se produire dans la base de données du répertoire, puisque des objets identiques ou similaires sont mis à niveau simultanément lors de transactions associées aux requêtes. Ceux-ci sont rares, mais normaux. Le système est conçu pour se protéger contre ce genre d'incidents, et l'intégrité des données est conservée ; il n'y a pas de perte de données. Occasionnellement, des blocages sont consignés par tâches, par exemple l'exécution du moteur de génération. En règle générale, la cause est détectée, et la tâche est réessayée. Une génération ayant échouée peut être le résultat d'un blocage. Dans de très rares cas, il se peut qu'une action d'un utilisateur, par exemple le travail avec des éléments de travail ou avec un code source, soit annulée pour résoudre un blocage. Dans ce cas, l'action de l'utilisateur échoue et un message d'erreur détaillé concernant un blocage est affiché à l'utilisateur. L'utilisateur peut ensuite réessayer l'action.

Tous les blocages rencontrés sont consignés sur le serveur, fournissant des informations concernant la cause et les circonstances du blocage. L'entrée du journal contient des informations telles que : com.ibm.team.repository.common.RetryableDatabaseException: Serialization failure.

Si votre système rencontre des blocages, reportez-vous au journal des erreurs à l'adresse suivante : https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.

Si vous rencontrez des exceptions fréquentes de blocage, contactez le service de support du produit, ou consultez les dernières informations, mises à niveau ou techniques de contournement sur les forums sur jazz.net.

Création des tables de base de données de Jazz Team Server

Créez les tables de base de données à l'aide des outils de référentiel.

A propos de cette tâche

Pour créer les tables de base de données, procédez comme suit :

  1. Exécutez la commande repotools -createTables pour créer les tables de base de données pour un référentiel Jazz.

    Le fichier repotools se trouve dans JazzInstallDir/server.

    La commande utilise les propriétés de configuration de teamserver.properties pour les paramètres de connexion et de taille. Par défaut, la commande recherche dans le répertoire en court. Le paramètre teamserver.properties peut être utilisé pour faire référence à un fichier de propriétés différent.

    Cette commande permet de créer l'espace de table, ainsi que toutes les tables et tous les index dont à besoin un référentiel Jazz Team Server.
  2. Une fois créées les tables de base de données, vous devez arrêter et redémarrer la base de données pour vous assurer que toutes les modifications ont été prises en compte.
    Conseil :
    Les commandes db2stop et db2start sont des exemples de commande permettant d'arrêter et de démarrer DB2. Ces commandes sont exécutées dans la fenêtre de commande DB2. La fenêtre de commande peut être ouverte à partir du menu de démarrage de l'application sous le menu en cascade des outils de ligne de commande DB2.

Résultats

La configuration de votre base de données est terminée. Vous pouvez continuer par Démarrage du serveur.

Démarrage du serveur

Cette rubrique décrit les différentes options d'exécution des scripts de démarrage du serveur.

A propos de cette tâche

Si vous prévoyez d'utiliser le serveur d'applications Apache Tomcat inclus, vous êtes prêt à démarrer Jazz Team Server.

Si vous prévoyez d'utiliser WebSphere Application Server, configurez votre environnement de serveur comme indiqué dans la rubrique Configuration d'un WebSphere Application Server.

Démarrage du serveur Apache Tomcat

Vous êtes désormais prêt à démarrer le serveur Apache Tomcat.

Apache Tomcat a été installé dans le répertoire JazzInstallDir/server/tomcat. L'application Web (jazz.war) a été installée dans le répertoire Apache Tomcat webapps. Dans une fenêtre de commande, établissez votre répertoire en cours dans JazzInstallDir/server. Les scripts de configuration et d'arrêt du serveur se trouvent dans ce répertoire.

Démarrage du serveur sous Windows

Exécutez le fichier d'initialisation pour démarrer votre serveur sous Windows.

A propos de cette tâche

  1. Pour démarrer le serveur, à partir du répertoire JazzInstallDir/server, exécutez la commande suivante :
    server.startup.bat
    Remarque :
    Une fenêtre console Apache Tomcat distincte s'ouvre. Ne la fermez pas ou le serveur cessera de fonctionner. De même, plusieurs messages d'information s'affichent, notamment un message concernant la bibliothèque native d'Apache Tomcat. Ces messages d'information n'ont aucun impact sur le fonctionnement de Jazz Team Server.
  2. Pour arrêter le serveur, à partir du répertoire JazzInstallDir/server, exécutez la commande suivante :
    server.shutdown.bat

Que faire ensuite

Remarque :
L'exemple ci-dessus exécute les scripts de démarrage et d'arrêt directement à partir du répertoire JazzInstallDir/server. Si vous avez installé Jazz Team Server à l'aide d'IBM Installation Manager, vous pouvez également exécuter les commandes à partir du menu de démarrage Windows de Jazz Team Server.

Une fois créé le serveur, passez à la section Exécution de l'assistant de configuration.

Démarrage du serveur sous Linux

Exécutez le fichier de démarrage pour démarrer le serveur sous Linux.

A propos de cette tâche

  1. Pour démarrer le serveur, à partir du répertoire JazzInstallDir/server, en tant qu'utilisateur racine, exécutez la commande suivante :
    ./server.startup
    Si votre ID utilisateur détient les droits administrateur, exécutez la commande suivante :
    sudo ./server.startup

    Un fenêtre console Apache Tomcat distincte n'est pas visible. Vous pouvez suivre le déroulement du démarrage du serveur en affichant le fichier journal dans JazzInstallDir/server/tomcat/logs/catalina.out.

  2. Pour arrêter le serveur, à partir du répertoire JazzInstallDir/server, en tant qu'utilisateur racine, exécutez la commande suivante :
    ./server.shutdown
    Si votre ID utilisateur détient les droits administrateur, exécutez la commande suivante :
    sudo ./server.shutdown

Que faire ensuite

Remarque :
Cet exemple exécute les scripts de démarrage et d'arrêt directement à partir du répertoire JazzInstallDir/server. Si vous avez installé Jazz Team Server à l'aide d'IBM Installation Manager, vous pouvez également exécuter les commandes à partir du menu de démarrage de l'application Jazz Team Server.

Une fois créé le serveur, passez à la section Exécution de l'assistant de configuration.

Configuration d'un WebSphere Application Server

Cette rubrique explique comment configurer Jazz Team Server pour travailler avec WebSphere Application Server. Cette configuration suppose d'installer Jazz Team Server sur le même poste que Websphere Application Server.

Avant de commencer

Avant d'entamer cette procédure, vérifiez que les étapes suivantes ont été réalisées :

Conseil :
Si vous utilisez IBM Installation Manager, les fichiers Jazz Team Server peuvent être installés dans un répertoire d'application Web. Lors du processus d'installation, il est recommandé de ne pas installer le serveur d'applications Apache Tomcat inclus. En effet, Installation Manager risque de demander un répertoire d'application Web et de n'installer que les fichiers nécessaires à WebSphere. Le répertoire par défaut est C:\Program Files\IBM\JazzTeamServer on Windows ou /opt/IBM/JazzTeamServer on Linux. Dans cette procédure, le répertoire d'installation s'appelle JazzInstallDir. Si vous utilisez IBM Installation Manager pour installer les fichiers dans le répertoire des applications Web de WebSphere Application Server, il n'est pas utile de déplacer manuellement le fichiers comme indiqué ci-dessus.

A propos de cette tâche

Remarque :
Ce document n'explique pas comment configurer l'authentification WebSphere ou SSL, qui est une rubrique complexe. Des informations détaillées relatives aux différentes options d'authentification et de chiffrement de WebSphere sont présentées dans l'Information Center de WebSphere. Pour plus d'informations, accédez à WebSphere Information Center et recherchez Securing applications and their environment. L'interface utilisateur Web Jazz requiert de configurer l'authentification afin de procéder aux autorisations et de personnaliser l'application.

  1. Modifiez les fichiers profile.ini et license-profile.ini :

    Modifiez chacun des profils dans JazzInstallDir/server/provision_profiles/ et définissez un chemin d'accès absolu pour la propriété URL.

    Par exemple,

    Remarque :
    Le répertoire JazzInstallDir/server/provision_profiles/ doit uniquement contenir les fichiers .ini inclus et ne doit contenir aucun fichier de sauvegarde. Certains éditeurs sauvegardent automatiquement un fichier de sauvegardes qui doit être supprimé.
  2. Examinez et mettez à jour l'emplacement de la base de données du fichier teamserver.properties
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
  3. Vérifiez ou mettez à jour le niveau WebSphere Application Server.

    Jazz Team Server requiert WebSphere Application Server Version 6.1 avec le groupe de correctifs IBM Java SDK 1.5 SR5 ou ultérieur. La mise à jour d'IBM Java SDK 1.5 SR6 SDK est disponible dans http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Avec WebSphere 6.1 et GA IBM Java SDK, Jazz commence à rapporter les "erreurs de proxy" après un certain nombre d'opérations.

  4. Mettez à jour les arguments JVM.

    Jazz Team Server a besoin de certains paramètres spécifiques sur la machine virtuelle Java dans laquelle ils sont exécutés.

    En premier lieu, il doit savoir où se trouvent les fichiers de configuration du serveur et log4j, l'utilitaire de gestion des journaux utilisé par le serveur. Pour ce faire, il suffit de paramétrer les propriétés système com.ibm.team.server.configURL et log4j.configuration. Ces propriétés utilisent une adresse URL plutôt qu'un simple chemin d'accès. La valeur doit dont être spécifiée en tant que fichier://-style URL.

    La deuxième propriété requise pour la machine virtuelle Java de Jazz doit être fournie avec une valeur d'allocation de mémoire maximale par défaut supérieure, à l'aide du paramètre -Xmx. Cette valeur doit être définie en fonction de la taille de l'équipe prise en charge par le serveur et de la capacité de mémoire du serveur sur lequel Jazz Team Server fonctionne. Une équipe de taille moyenne peut utiliser une valeur de -Xmx1000M, offrant une mémoire instantanée de 1000 Mo pour le processus Jazz Team Server.

    Si vous vous connectez à une base de données Oracle, vous devez ajouter une propriété appelée "ORACLE_JDBC". Attribuez à la propriété le chemin d'accès absolu au fichier (par l'URL) des pilotes de périphérique JDBC Oracle.

    D'autres propriétés système, présentées ci-dessous, doivent être définies pour contrôler le comportement du serveur. Voici les caractéristiques de définition de ces propriétés JVM dans WebSphere Administrative Console, remplacez JazzInstallDir par votre répertoire d'installation Jazz Team Server :

    1. Cliquez sur Serveurs -> Serveurs d'applications.
    2. Cliquez sur server1.
    3. Cliquez sur Gestion des processus et Java -> Définition des processus.
    4. Cliquez sur Machine virtuelle Java.
    5. Ajoutez la valeur 100 dans la zone Initial Heap (Segment mémoire initial).
    6. Ajoutez la valeur 1000 dans la zone Taille maximum de la pile.
    7. Cliquez sur Appliquer.
    8. Cliquez sur Logging and Tracing (Consignation et traçage). Cliquez sur Change Log Detail Levels (Modifier les niveaux de détails du journal). Le Jazz Team Server utilise le moteur de génération de rapports BIRT. Pour empêcher que les entrées d'information BIRT ne soient écrites dans le fichier journal WebSphere, définissez le niveau de consignation des modules org.eclipse.birt.* sur grave. Cliquez sur Appliquer.
    9. Cliquez sur Propriétés personnalisées
    10. Ajoutez les propriétés suivantes : Cliquez sur Nouveau, entrez le Nom et la Valeur, puis cliquez sur OK.
      • Nom : com.ibm.team.repository.provision.profile Valeur : file:///JazzInstallDir/server/provision_profiles (comme l'URL du fichier)
        Remarque :
        La propriété com.ibm.team.repository.provision.profile doit point vers le répertoire contenant les provision_profiles.
      • Nom : com.ibm.team.server.configURL Valeur : file:///JazzInstallDir/server/teamserver.properties (comme l'URL du fichier)
      • Nom : log4j.configuration Valeur : file:///JazzInstallDir/server/log4j.properties (comme l'URL du fichier)
      • Nom : java.awt.headless Valeur : true
      • Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true
    11. Cliquez sur Sauvegarder directement dans la configuration principale.
  5. Redémarrez Websphere pour installer l'application Jazz

    Dans les exemples de ligne de commande suivantes, WASInstallDir représente l'emplacement dans lequel est installé WebSphere Application Server sur votre serveur.

    1. Ouvrez la console d'administration de WebSphere Application Server.
    2. Cliquez sur Applications -> Installation d'une nouvelle application.
    3. Sous Chemin d'accès, cliquez sur Chemin d'accès au système de fichiers local.
    4. Sous Chemin d'accès complet, entrez :
      JazzInstallDir/server/jazz.war
    5. Attribuez la valeur /jazz à Racine du contexte.
    6. Cliquez sur Suivant et reprenez l'étape Installation d'une nouvelle application restante.
    7. Cliquez sur Terminer.
    8. Cliquez sur Sauvegarder directement dans la configuration principale.
    9. Cliquez sur Applications -> Applications d'entreprise.
    10. Cochez la case en regard de jazz_war, puis cliquez sur Démarrer.

      Une flèche verte apparaît et indique que l'application a bien démarré.

Que faire ensuite

Une fois créé le serveur, passez à la section Exécution de l'assistant de configuration.

Exécution de l'assistant de configuration

L'assistant de configuration vérifie que le serveur fonctionne correctement et vous accompagne tout au long de la procédure de configuration du serveur.

A propos de cette tâche

Pour vérifier que Jazz Team Server se connecte à la base de données, consultez le journal du serveur ou la sortie de la console. Les informations relatives à la connexion et à la base de données sont reprises lors de leur premier accès. Le répertoire JazzInstallDir/server/tomcat/logs est utilisé pour les fichiers journaux du serveur.

Cette procédure suppose que votre serveur est disponible à l'aide du nom d'hôte, de l'hôte local et des ports par défaut 9443. Le cas échéant, remplacez l'hôte local par le nom d'hôte de votre serveur et remplacez le port 9443.

Lancez l'assistant de configuration pou configurer votre serveur. Utilisez l'URL https://localhost:9443/jazz/setup.
Le nom d'utilisateur et le mot de passe par défaut sont sensibles à la casse :

Si vous avez configuré le conteneur Web de l'annuaire LDAP, connectez-vous avec un utilisateur JazzAdmin défini dans votre annuaire LDAP.

Choisissez un chemin de configuration. L'assistant de configuration comporte deux chemins principaux.



A l'issue de la configuration initiale, des options supplémentaires peuvent être configurées à partir de l'interface utilisateur Web de l'administrateur Jazz Team Server en utilisant l'URL https://localhost:9443/jazz/admin.

Que faire ensuite

Si l'assistant de configuration du serveur ne se charge pas, vérifiez les éléments suivants :

Procédure d'installation

Une fois installé le serveur, vous devez tenir compte de certaines options de configuration avant de poursuivre.

A propos de cette tâche

A l'issue de l'installation, vous devez réaliser quelques actions supplémentaires.

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.

Installation de l'Build System Toolkit à partir d'IBM Installation Manager

L'Build System Toolkit peut être installé sur des machines de génération à l'aide d'IBM Installation Manager.

A propos de cette tâche

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

    Si Installation Manager ne fonctionne pas, démarrez-le.

    Remarque :
    Vous devez détenir les droits d'administrateur pour exécuter le tableau de bord.
  2. Lorsque le programme de tableau de bord apparaît, cliquez sur l'Build System Toolkit pour lancer le processus d'installation.
  3. A l'issue de l'installation, il est recommandé de configurer une génération. Plus d'informations relatives à l'Build System Toolkit sont disponibles dans la rubrique A propos de la génération d'équipe Jazz.

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 :


Commentaires en retour