Installation de Rational Team Concert Standard 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 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.
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.
workitemindex (répertoire)
Si vous utilisez Derby, copiez l'arborescence de répertoires repositoryDB
.
Si vous utilisez Tomcat et que vous avez modifié la configuration, copiez
le répertoire tomcat/conf.
Si vous utilisez la base de données utilisateur Tomcat, copiez tomcat-users.xml.
Si vous utilisez Tomcat et que vous avez personnalisé le descripteur de déploiement
d'application, copiez le fichier modifié web.xml pour jazz.war,
situé dans \JazzTeamServer\server\tomcat\webapps\jazz\WEB-INF.
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 :
IBM Rational Team Concert Express
Edition - Server License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert Express
Edition - Developer Client License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert -
Contributor Client License Activation Kit V1.0.1 Multiplatform
Clés pour l'édition Standard :
IBM Rational Team Concert Standard
Edition - Server License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert Standard
Edition - Developer Client License Activation Kit V1.0.1 Multiplatform
IBM Rational Team Concert -
Contributor Client License Activation Kit V1.0.1 Multiplatform
Installation de l'édition Standard - Présentation
Le module d'installation comprend tous les éléments dont vous avez besoin pour démarrer.
La configuration par défaut comprend :
Les versions prises en charge d'un JDK (Java Development Kit) pour
Windows et
Linux.
Une image de travail d'un serveur d'applications Web Apache Tomcat contenant l'application Web
Jazz.
Une base de données Derby et toutes les bibliothèques de base de données nécessaires.
Important :
L'utilisation
de Jazz Team
Server avec une base de données Derby
permet de prendre en charge jusqu'à 10 utilisateurs. Pour prendre en charge plus de 10 utilisateurs, utilisez une base de données
DB2 Express, DB2 ou Oracle. DB2 Express est inclus dans les modules d'installation
des éditions Standard et Express lorsque vous utilisez IBM Installation Manager. Si vous utilisez la méthode d'installation à l'aide du
fichier .zip, le téléchargement DB2 Express est disponible sur le même site que celui de
Rational Team Concert.
Une fois installé
DB2 Express, vous devez l'installer et le configurer comme indiqué dans le manuel de configuration de l'installation.
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 de l'édition Standard
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.
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.
Les noms de chemin de l'installation Jazz Team
Server
ne doivent pas contenir d'espace. Le script de démarrage
(JazzInstallDir/server/server.startup)
et le script des outils de référentiel
(JazzInstallDir/server/repotools.sh)
détectent et rapportent cet incident.
Augmentez à 5000 le nombre maximal de fichiers que l'utilisateur Apache Tomcat peut traiter. Sur Redhat Enterprise
Linux, vous pouvez ajouter les lignes suivantes dans
/etc/security/limits.conf :
tomcat_user hard nofile 5000
tomcat_user soft nofile 5000
Le composant Rapports requiert l'installation de bibliothèques X11 32 bits sur le serveur. Sous Redhat Enterprise
Linux 5, les modules requis sont
libXp, libXinerama et mesa-libGL.
Si vous installez DB2 sous Linux, attribuez la valeur 1 Go à shmmax.
Installation de Standard 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.
Téléchargez l'un des modules d'installation ci-dessous. Choisissez la plateforme d'installation.
Il existe deux méthodes d'installation de
Rational Team Concert Standard Edition
à l'aide d'IBM Installation Manager.
Installation Web d'Installation Manager pour le client, le serveur et les composants facultatifs :
ce fichier archive contient les emplacements du programme Installation Manager et du répertoire d'installation prédéfini.
Il s'agit d'un fichier
auto-extractible qui lance le programme IBM Installation Manager après l'extraction du contenu. Le module d'installation Web présente
l'avantage de réduire la taille du téléchargement initial, le processus d'installation ne téléchargeant que les ressources que vous avez choisi d'installer.
Remarque :
L'installation
Web requiert une connexion Internet lors du processus d'installation.
Fichier .zip Full DVD Contents : ce fichier archive contient le programme Installation Manager
et une copie locale de toutes les ressources installables. L'utilisation du module d'installation local présente l'avantage de
permettre l'installation sans connexion Internet. Il ne s'agit pas un fichier .zip d'auto-extraction.
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.
Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire
et un tableau de bord s'affiche.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
RTC-édition-Full-version-Win-Web.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh RTC-édition-Full-version-Linux-Web.sh
Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
launchpad.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh launchpad.sh
Au démarrage du programme de tableau de bord, une liste des éléments à installer s'affiche. Installez les modules que vous souhaitez
utiliser dans l'ordre répertorié.
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.
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.
Installez le client Rational Team Concert.
Facultatif : installez l'Build
System Toolkit.
Facultatif : installez l'ClearCase Connector .
Facultatif : installez l'ClearQuest Connector .
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 :
Configurez une base de données DB2 ou
DB2 Express pour travailler avec
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.
Consultez la documentation DB2 pour vérifier que votre système répond à toutes les exigences et qu'il est correctement configuré.
DB2 est installé et fonctionne sur une machine devant
faire office de serveur de base de données. Cette machine peut être différente de celle sur qui héberge
Jazz Team
Server.
L'utilisateur se conformant à ces instructions détient les droits d'administrateur sur la base de données
DB2.
Conseil :
Pour obtenir les droits d'administrateur
système sur la base de données DB2 sous Linux,
accédez à l'utilisateur DB2 db2fenc1 et exécutez la commande bash.
A propos de cette tâche
Pour configurer une base de données DB2, procédez comme suit :
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. La fenêtre de commande peut être ouverte à partir du menu Démarrer de
l'application sous le menu en cascade des outils de ligne de commande
DB2.
Sous Windows :
db2 create database JAZZ on c: using codeset UTF-8 territory en
Sous Linux :
db2 create database JAZZ using codeset UTF-8 territory en
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.
Recherchez le fichier teamserver.properties dans le répertoire
JazzInstallDir/server
te renommez-le teamserver.derby.properties.
Recherchez le fichier teamserver.db2.properties dans le répertoire
JazzInstallDir/server
et renommez-le teamserver.properties.
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. 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.
Ouvrez le fichier teamserver.properties dans un éditeur de texte.
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.
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.
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.
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 (com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace, par exemple).
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.
Oracle est installé sur une machine devant faire office de serveur de base de données.
Cette machine peut être différente de celle sur qui héberge
Jazz Team
Server.
Une base de données par défaut est présente sur le serveur Oracle.
Remarque :
Lors de l'installation d'Oracle, vous avez la possibilité de créer automatiquement une base de données.
Remarque :
Pour garantir le traitement correct du contenu Unicode, le jeu de caractères de la base de données doit être UTF-8.
L'utilisateur qui se conforme à ces instructions détient les droits d'administration sur la base de données Oracle.
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 :
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.
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 :
Création d'une session.
Création, modification et suppression des tables et des index.
Insertion, mise à jour et suppression des tables créées.
Recherchez le fichier teamserver.properties dans le répertoire
JazzInstallDir/server
te renommez-le teamserver.derby.properties.
Recherchez le fichier teamserver.oracle.properties dans le répertoire
JazzInstallDir/server
et renommez-le teamserver.properties.
Configurez le serveur
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 :
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.
Dans le même répertoire que les scripts de serveur
(JazzInstallDir/server),
créez un répertoire nommé oracle.
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.
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 :
Créez une base de données Jazz Team
Server.
A partir de l'outil de ligne de commande, entrez :
CREATE DATABASE jazz
GO
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
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 :
Renommez les fichiers suivants :
Renommez le fichier JazzInstallDir/server/ teamserver.properties
en teamserver.OtherDBProvider.properties
Renommez le fichier teamserver.sqlserver.properties en teamserver.properties
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.
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
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.
Indiquez l'emplacement du fichier JDBC JAR pour JDBC en exécutant l'une des tâches
suivantes :
Copiez le fichier JAR des pilotes JDBC dans le répertoire JazzInstallDir/server/sqlserver
Configurez la variable d'environnement SQLSERVER_ABSPATH pour
pointer sur le répertoire contenant le fichier JAR
Remarque :
Si vous utilisez WebSphere Application
Server, configurez une propriété nommée SQLSERVER_JDBC ; puis
attribuez-lui le chemin absolu (pas l'URL) du répertoire des pilotes JDBC du
serveur SQL. Pour plus d'informations, consultez les instructions de configuration du
WebSphere Application Server. Notez le chemin pour une utilisation ultérieure dans ces instructions.
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 :
Le serveur SQL est configuré de manière à autoriser les connexions utilisant le protocole TCP/IP.
Si nécessaire, redémarrez le service SQL.
Le nom d'hôte de la machine du serveur SQL et le port apparaissent correctement
dans le fichier teamserver.properties.
Le nom de connexion, le mot de passe et le nom de la base de données apparaissent correctement dans
le fichier teamserver.properties.
Un pare-feu ne vous empêche pas d'accéder au serveur SQL. Utilisez une commande
telnet pour accéder à la machine en utilisant le nom d'hôte et le port à partir du fichier teamserver.properties.
L'utilisateur créé a les autorisations appropriées pour accéder à la base de données Jazz Team
Server database.
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 :
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.
Sous Windows :
repotools -createTables
Sous Linux :
./repotools.sh -createTables
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.
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.
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.
Si vous souhaitez exécuter les scripts de démarrage et d'arrêt à partir d'un autre répertoire, vous devez modifier le fichier profiles.ini dans
JazzInstallDir/server/provision_profiles
pour utiliser le chemin d'accès absolu.
Apache Tomcat est configuré pour utiliser les ports 9080 et 9443 dans le fichier
JazzInstallDir/server/tomcat/conf/server.xml.
Le cas échéant, modifiez-les en fonction de votre système. Si nécessaire, mettez également à jour les paramètres de configuration des
ports HTTP de référentiel du serveur Jazz dans la page de configuration des propriétés avancées de l'interface utilisateur Web de
l'administrateur Jazz.
Le répertoire JazzInstallDir/server/tomcat/logs
contient les fichiers journaux du serveur. Consultez-les si vous avez des difficultés à démarrer le serveur.
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
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.
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.
Exécutez le fichier de démarrage pour démarrer le serveur sous
Linux.
A propos de cette tâche
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.
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.
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 :
WebSphere Application Server est déjà installé.
La base de données a été créée et que ses paramètres ont été utilisé pour mettre à jour le fichier teamserver.properties.
Consultez la documentation WebSphere pour la configuration de la
sécurité et la désactivation de la propriété insensible à la casse.
Remarque :
Bien que la connexion à
Websphere et à la plupart des répertoires LDAP soit insensible à la casse,
Jazz Team
Server
stocke les enregistrements utilisateur avec les ID utilisateur en conservant la casse exacte utilisée lors de leur importation. Lors de la connexion à
Jazz Team
Server, l'enregistrement utilisateur
est extrait de la liste des utilisateurs et la casse doit correspondre exactement.
L'option Java 2 Security doit
être désactivée.
Si cette option est activée dans WebSphere Application Server, le démarrage de
Jazz Team
Server .war n'aboutit pas.
Jazz Team
Server inclut les fichiers nécessaires à
l'exécution complète du serveur Apache Tomcat. Pour installer WebSphere,
vous avez simplement besoin d'un sous-ensemble de fichiers
Jazz Team
Server que vous placez dans un répertoire de votre
machine serveur WebSphere. D'autres instructions
l'appelle répertoire d'installation Jazz Team
Server (ou
JazzInstallDir en abrégé). A partir de ce répertoire, utilisez :
le fichier JazzInstallDir/server/teamserver.properties.
le fichier JazzInstallDir/server/log4j.properties.
Si
vous utilisez Websphere Application Server, vous pouvez modifier dans ce fichier le chemin d'accès du fichier jazz.log, qui consigne uniquement les
messages provenant de Jazz Team
Server.
Le chemin par défaut est tomcat/logs/jazz.log.
le fichier JazzInstallDir/server/tomcat/webapps/jazz.war.
le répertoire JazzInstallDir/server/provision_profiles.
le répertoire JazzInstallDir/server/update-site.
la base de données de référentiel par défaut dans JazzInstallDir/repositoryDB.
les outils de référentiel dans JazzInstallDir/repotools.
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.
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.
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é.
Examinez et mettez à jour l'emplacement de la base de données du fichier teamserver.properties
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.
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 :
Cliquez sur Serveurs -> Serveurs d'applications.
Cliquez sur server1.
Cliquez sur Gestion des processus et Java -> Définition des processus.
Cliquez sur Machine virtuelle Java.
Ajoutez la valeur 100 dans la zone Initial Heap (Segment mémoire initial).
Ajoutez la valeur 1000 dans la zone Taille maximum de la pile.
Cliquez sur Appliquer.
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.
Cliquez sur Propriétés personnalisées
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
Cliquez sur Sauvegarder directement dans la configuration principale.
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.
Sous Windows, la valeur par défaut du répertoire d'installation
WebSphere est la suivante :
C:\Program Files\IBM\WebSphere\AppServer
Vous
pouvez redémarrer le serveur avec les commandes suivantes sous
Windows :
cd WASInstallDir\bin
stopServer.bat server1 [for a secure server, include: -username {utilisateur_LDAP} -password {mot_de_passe_LDAP}]
startServer.bat server1
Sous Linux,
la valeur par défaut du répertoire d'installation WebSphere est la suivante :
/opt/IBM/WebSphere/AppServer
Vous
pouvez redémarrer le serveur avec les commandes suivantes sous
Linux :
cd WASInstallDir/bin
./stopServer.sh server1 [pour un serveur sécurisé, inclure : -username {utilisateur_LDAP} -password {mot_de_passe_LDAP}]
./startServer.sh server1
Ouvrez la console d'administration de WebSphere Application Server.
Cliquez sur Applications -> Installation d'une nouvelle application.
Sous Chemin d'accès, cliquez sur Chemin d'accès au système de fichiers local.
Sous Chemin d'accès complet, entrez :
JazzInstallDir/server/jazz.war
Attribuez la valeur /jazz à Racine du contexte.
Cliquez sur Suivant et reprenez l'étape Installation d'une nouvelle application restante.
Cliquez sur Terminer.
Cliquez sur Sauvegarder directement dans la configuration principale.
Cliquez sur Applications -> Applications d'entreprise.
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é.
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 :
Le nom d'utilisateur est ADMIN.
Le mot de passe est ADMIN.
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.
La configuration rapide du chemin d'accès utilise la configuration par défaut. Si vous souhaitez que le serveur s'exécute rapidement,
la configuration rapide du chemin d'accès est une bonne option. Lors de la configuration rapide du chemin d'accès, configurez
le registre d'utilisateurs.
La configuration personnalisée permet de procéder à une configuration détaillée du serveur,
y compris la possibilité d'activer les notifications par courrier électronique.
Lors de la configuration personnalisée,
configurez les éléments suivants :
Base de données
Notification par courrier électronique
Registre d'utilisateurs
Remarque :
Par défaut, le serveur est configuré de manière à utiliser Derby comme base de données. Pour utiliser une autre base de données, telle que DB2, sélectionnez le chemin d'accès de la configuration personnalisée et passez à
l'étape 2 : Configuration de la base de données.
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 :
Vérifiez que le serveur d'applications a démarré. Utilisez l'URL
http://localhost:9080.
Vérifiez que Jazz Team
Server a démarré en vous connectant
à l'interface utilisateur Web de l'administrateur Jazz Team
Server
à l'aide de l'URL https://localhost:9443/jazz/admin.
Si la page ne se charge pas ou que le serveur comporte
des erreurs, le serveur ne démarre pas correctement. Voir les informations relatives à l'identification et la résolution
des incidents à l'adresse suivante :
Identification et résolution des incidents liés au serveur.
La racine URI du chemin Jazz Team
Server
doit être /jazz. Par exemple : https://example.com:9443/jazz doit être utilisé à la place de https://example.com:9443.
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.
Certains fichiers contiennent des mots de passe. Ces fichiers doivent être protégés de manière à ne pouvoir être consultés que
par les utilisateurs autorisés à connaître le mot de passe des comptes.
teamserver.properties - Jazz Team
Server
demande de stocker le mot de passe de base de données dans
JazzInstallDir/server/teamserver.properties.
Lors de la sauvegarde des
fichiers de propriétés, l'application procède toujours à une copie de sauvegarde de la version précédente dans le même répertoire. Si vous souhaitez supprimer tous
les fichiers contenant le mot de passe en texte clair, supprimez les fichiers de propriétés de sauvegarde à l'issue de la première configuration
du serveur.
Le moteur de synchronisation de
ClearCase Connector nécessite le stockage des mots de
passe utilisateur dans un fichier de propriétés.
cqconnector.properties - ClearQuest Connector
requiert le stockage ClearQuest des ID utilisateur et des mots
de passe dans un fichier de propriétés.
Lors de la connexion au serveur avec le client
Rational Team Concert ou un navigateur Web,
les avertissements de certificat de sécurité s'affichent.
Pour désactiver l'avertissement, voir
Configuration des paramètres du certificat de sécurité.
Si vous avez configuré le serveur d'applications pour utiliser des ports autres que les ports par défaut, ces ports doivent également être
configurés dans la configuration Jazz.
Ces numéros de port sont utilisés pour composer des URL pour des éléments comme les liens du canal de communication et les liens
d'élément dans des notifications par courrier électronique. Pour mettre à jour les valeurs par défaut, utilisez la page de configuration des
propriétés avancées de l'interface utilisateur Web de l'administrateur afin de modifier les propriétés suivantes :
Vous pouvez désormais connecter le serveur au client
Rational Team Concert ou au navigateur Web.
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.
Téléchargez l'un des modules d'installation ci-dessous.
Il existe trois méthodes d'installation du client
Rational Team Concert.
Fichier .zip Client CD Contents - Installation locale d'Installation Manager pour le client : ce fichier archive contient le programme
Installation Manager et une copie locale du client
Rational Team Concert.
L'utilisation du module d'installation local présente l'avantage de
permettre l'installation sans connexion Internet. Ce fichier .zip n'est pas auto-extractible.
Installation Web d'Installation Manager pour le client, le serveur et les composants facultatifs :
ce fichier archive contient les emplacements du programme Installation Manager et du répertoire d'installation prédéfini.
Il s'agit d'un fichier
auto-extractible qui va démarrer le programme IBM Installation Manager après l'extraction du contenu. Le module d'installation Web présente
l'avantage de limiter le téléchargement initial, le processus d'installation ne téléchargeant que les ressources que vous avez choisi d'installer.
Remarque :
L'installation
Web requiert une connexion Internet lors du processus d'installation.
Fichier .zip Full DVD Contents : ce fichier archive contient le programme Installation Manager
et une copie locale de toutes les ressources installables. L'utilisation du module d'installation local présente l'avantage de
permettre l'installation sans connexion Internet. Ce fichier .zip n'est pas auto-extractible.
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 :
Si vous utilisez le fichier .zip Client CD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord. Pour démarrer le fichier du tableau de bord sur :
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
launchpad.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh launchpad.sh
Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire
et un tableau de bord s'affiche. Pour lancer le fichier exécutable sur :
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
RTC-édition-Full-version-Win-Web.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh RTC-édition-Full-version-Linux-Web.sh
Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord. Pour démarrer le fichier du tableau de bord sur :
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
launchpad.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh launchpad.sh
Vous pouvez installer les clients suivants :
Pour installer le client Rational Team Concert
pour Eclipse, cliquez sur le lien Rational Team Concert Client
for Eclipse IDE.
Pour installer le client Rational Team Concert for Microsoft Visual Studio, cliquez sur le lien Rational Team Concert Client for Microsoft Visual Studio IDE .
L'assistant d'Installation Manager s'affiche.
L'assistant vous accompagne tout au long de l'installation du client.
Démarrez le client en cliquant sur le raccourci
Rational Team Concert créé par l'installation.
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.
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.
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.
Commencez avec un espace de travail vide.
Les générations du client et du serveur doivent correspondre. Vérifiez les correspondances d'ID génération pour les distributions du client et du serveur.
Vérifiez que le serveur est en cours de fonctionnement. Confirmez l'URL de l'état : https://example.com:9443/jazz.
Sous Linux, si vous ne souhaitez pas démarrer le client à partir du répertoire
JazzInstallDir/client/eclipse, vous devez
modifier tous les fichiers dans JazzInstallDir/client/eclipse/links/
et inclure le chemin d'accès absolu vers le répertoire nommé. Par défaut, les chemins relatifs sont utilisés. Par exemple,
JazzInstallDir/client/eclipse/links/build.link
contient le texte "path=jazz/build". Si votre client est installé dans le répertoire /home/username/teamconcert, éditez le fichier de la manière suivante :
"path=/home/username/teamconcert/jazz/client/eclipse/build".
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
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.
Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire
et un tableau de bord s'affiche.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
RTC-édition-Full-version-Win-Web.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh RTC-édition-Full-version-Linux-Web.sh
Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
launchpad.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh launchpad.sh
Lorsque le programme de tableau de bord apparaît, cliquez sur
l'Build
System Toolkit
pour lancer le processus d'installation.
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
ClearCase Connector à l'aide
d'IBM Installation Manager
L'ClearCase Connector peut être installé sur des machines de
génération à l'aide d'IBM Installation Manager.
A propos de cette tâche
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.
Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire
et un tableau de bord s'affiche.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
RTC-édition-Full-version-Win-Web.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh RTC-édition-Full-version-Linux-Web.sh
Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
launchpad.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh launchpad.sh
Lorsque le programme de tableau de bord apparaît, cliquez sur
l'ClearCase Connector
pour lancer le processus d'installation.
Installation de Rational Team Concert
ClearQuest Connector à l'aide
d'IBM Installation Manager
L'ClearQuest Connector peut être installé sur des machines de
génération à l'aide d'IBM Installation Manager.
A propos de cette tâche
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.
Si vous utilisez l'installation Web Installation Manager, lancez le fichier exécutable. Les fichiers sont extraits dans un répertoire
et un tableau de bord s'affiche.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
RTC-édition-Full-version-Win-Web.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh RTC-édition-Full-version-Linux-Web.sh
Si vous utilisez le fichier .zip Full DVD Contents, extrayez le contenu de l'archive dans un répertoire temporaire, puis lancez le tableau de bord.
Pour exécuter le fichier sous Windows, exécutez la commande suivante :
launchpad.exe
Pour exécuter le fichier sous Linux, exécutez la commande suivante :
sh launchpad.sh
Lorsque le programme de tableau de bord apparaît, cliquez sur
l'ClearQuest Connector
pour lancer le processus d'installation.
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 :
SELinux est installé et désactivé par défaut sur Red Hat Enterprise
Linux 5.
SELinux n'est pas installé sur Suse Linux Enterprise Server 10 ni
Suse Linux Enterprise Desktop 10.
Pour désactiver SELinux, procédez de l'une des façons suivantes :
A partir du système de fenêtrage :
Sélectionnez System -> Administration -> Security Level and Firewall.
Cliquez sur l'onglet SELinux.
Attribuez la valeur Désactivé SELinux.
Cliquez sur OK pour sauvegarder le nouveau paramètre.
A partir de la ligne de commande :
Exécutez la commande "setup" (il s'agit de /usr/bin/setup)
Sélectionnez Firewall Configuration et appuyez sur Entrée
Utilisez les touches de tabulation et de déplacement du curseur pour attribuer la valeur Désactivé à SELinux
Sélectionnez OK et appuyez sur Entrée
Pour modifier le contexte de sécurité des JRE, procédez comme suit :
Si vous procédez à l'installation directement à partir d'un support DVD, passez à l'étape
2.
Sinon, modifiez le contexte de sécurité du JRE de l'installation.
Dans le répertoire des fichiers d'installation, recherchez le répertoire jre. linux/jre_5.0.2.sr5_20070511/jre.
Si vous extrayez les fichiers d'installation vers /tmp/rtc, le répertoire jre se trouve dans /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre.
Exécutez la commande chcon -R -t textrel_shlib_t en fonction du répertoire jre.
Cette commande traite les fichiers de manière récursive
et permet le transfert de texte. Par exemple, si vous extrayez les fichiers d'installation vers /tmp/rtc, exécutez la commande suivante :
Installez le serveur, le client et les connecteurs
Rational Team Concert, mais ne les démarrez pas.
Avant de commencer Rational Team Concert,
vous devez modifier le contexte de sécurité des JRE du produit. Pour chaque produit que vous installez, exécutez la commande
(chcon -R -t textrel_shlib_t) avec le répertorie JRE spécifique au produit. Les répertoires par défaut sont répertoriés ci-dessous.
Remarque :
Les chemins d'accès sont ceux par défaut si vous avez installé le produit en tant qu'utilisateur racine. Si vous avez procédé
à l'installation et que vous n'êtes pas un utilisateur racine, recherchez ces répertoires dans une structure opt/IBM
du répertoire de base de l'utilisateur de l'installation.