Installation d'IBM Rational
Team Concert Standard Edition ou Enterprise Edition à l'aide d'IBM Installation
Manager
Installation de Rational Team Concert Standard
Edition et Enterprise Edition
Mise à niveau vers Rational Team Concert 2.0
Généralement, vous pouvez mettre à niveau les clients et serveurs Rational Team Concert
en créant un fichier zip ou en effectuant l'installation à l'aide d'IBM
Installation Manager.
Remarque :
Si vous utilisez IBM Installation Manager pour installer Rational Team Concert
2.0 sur un ordinateur où Rational Team Concert
n'est pas installé, Installation Manager vous invite à sélectionner les langues
à installer. Cependant, si vous effectuez la mise à niveau d'une version antérieure vers la
version 2.0, IBM Installation Manager suppose que vous voulez utiliser
les langues actuelles et ne vous invite pas à sélectionner les langues. Pour
sélectionner les langues supplémentaires, une fois que vous avez effectué la
mise à niveau vers la version 2.0, sélectionnez
Modifier
à partir de l'écran principal d'IBM Installation Manager, puis sélectionnez les
langues proposées. L'écran suivant affiche la liste des langues prises en charge. Sélectionnez les langues
dont vous avez besoin.
Si vous démarrez Jazz Team Server une fois que vous avez migré vers la
version 2.0 et avant de sélectionner Modifier pour
ajouter ou supprimer des langues, vous devez redémarrer le serveur comme suit :
- Dans un navigateur Web, accédez à https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset.
- Cliquez sur Réinitialisation du serveur.
- Arrêtez le serveur.
Vous pouvez ensuite sélectionner Modifier dans IBM Installation Manager pour ajouter ou supprimer des langues.
Mise à niveau d'un client Rational Team Concert pour Eclipse IDE
Si
vous disposez de versions 1.0, 1.0.1 ou 1.0.1.1 du client pour Eclipse IDE,
vous devez vous procurer le client 2.0 pour vous connecter à votre nouveau
serveur version 2.0. Vous pouvez l'installer à l'aide d'un fichier zip, ou
mettre à niveau votre précédente installation d'IBM Installation Manager.
Installation d'un client Rational Team Concert
pour Microsoft Visual Studio IDE
Si vous disposez de la version
1.0.1.1 du client pour Microsoft Visual Studio IDE, vous devez vous procurer le
client 2.0 pour vous connecter à votre nouveau serveur version 2.0.
A faire :
Aucun
fichier .zip n'est fourni pour le client pour Microsoft Visual Studio. Pour
installer la version 2.0 ou y migrer, vous devez utiliser IBM Installation Manager.
La mise à niveau d'un serveur à partir d'une version Trial ou Early Access permet d'obtenir
une version permanente
Si vous exécutez une version Early Access de Rational Team Concert,
effectuez d'abord une mise à niveau vers la version Trial 2.0.
A partir
de la version Trial 2.0, vous pouvez rendre votre serveur permanent en achetant puis
en installant le Server Activation Kit pour votre édition, disponible à l'adresse suivante : http://www.ibm.com/software/awdtools/rtc/. Le kit d'activation est constitué d'un fichier JAR contenant la clé de licence serveur
permanente. Il est installé à l'aide de la page Gestion de clé de licence de l'interface
Web d'administration de votre serveur.
Mise à niveau d'un serveur 1.0, 1.0.1 ou 1.0.1.1
Vous
pouvez directement effectuer la mise à niveau vers la version 2.0 de Rational Team Concert
à partir des versions précédentes. Une migration de base de données est requise pour les mises à jour 1.x à 2.x.
Remarque :
Avant de commencer la mise à niveau de Websphere Application Server, réinitialisez le serveur en accédant à
https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset
et en cliquant sur Réinitialisation du serveur.
Si
vous avez installé la version précédente à partir d'un fichier zip, il n'y a pas d'interférence
avec l'installation précédente. Vous pouvez installer la version 2.0 à partir
d'un fichier zip à un nouvel emplacement ou utiliser IBM Installation Manager
pour installer une instance 2.0.
Si vous avez utilisé IBM Installation
Manager pour installer la version précédente, vous pouvez installer la version 2.0
comme instance distincte ou mettre à jour l'instance vers la version 2.0. Si
vous installez une instance séparée du serveur pour la version 2.0,
sélectionnez Créer un groupe de packages sur la page
Installation de packages de l'assistant d'installation.
Remarque :
Pour mettre à niveau un déploiement WebSphere Application
Server de Jazz Team Server,
supprimez le fichier jazz.war précédent et déployez le fichier jazz.war 2.0.
Pour terminer la mise à niveau, voir Copie des fichiers de configuration requis
à partir d'une installation de serveur précédente et Installation des clés d'activation 2.0.
Mise à niveau d'un serveur d'une édition de Rational Team Concert vers une autre
Vous pouvez effectuer une mise à niveau entre différentes éditions Rational Team Concert.
Il s'agit généralement de mises à niveau pour passer de l'édition Express-C à Express, ou Express à Standard. Vous
pouvez également rétromigrer vers une édition précédente en suivant le même processus.
Etant donné que toutes les éditions Rational Team Concert
2.0 prennent en charge les bases de données Derby, il n'est pas utile de migrer
de Derby vers DB2 ou Oracle si vous
passez de l'édition Express-C à Express ou Standard. Il est recommandé
de commencer par mettre à niveau votre édition serveur, en s'assurant que tout fonctionne correctement
avec la base de données existante, puis de migrer la base de données si nécessaire. Pour plus d'informations concernant la migration d'une base de données, voir Migration du référentiel Jazz après la mise à niveau de Jazz Team Server.
Si vous avez installé une édition Rational Team Concert 2.0 et que vous souhaitez la mettre à niveau, téléchargez et
installez la nouvelle édition, avec l'édition existante, puis copiez les
fichiers de configuration requis pour exécuter la nouvelle édition. La section suivante décrit les fichiers de configuration
requis.
Si vous avez installé votre édition précédente à partir d'un
fichier zip, il n'y a pas d'interférence avec l'installation précédente. Vous pouvez installer
la nouvelle édition à partir d'un fichier zip à un nouvel emplacement, ou utiliser IBM Installation
Manager pour installer une nouvelle édition. Il est recommandé d'utiliser IBM Installation Manager
pour des serveurs de production pour permettre des mises à niveau ultérieures.
Si
vous avez utilisé IBM Installation Manager pour effectuer votre installation de serveur précédente, et que vous
souhaitez utiliser IBM Installation Manager pour installer votre nouvelle édition, n'écrasez pas l'édition précédente
lors de l'installation avec Installation Manager. Sur la page Installation de packages de l'assistant d'installation, sélectionnez Créer
un groupe de packages.
Cette opération permet d'installer la nouvelle édition à un emplacement différent et de créer des raccourcis programme utilisant le nom du
nouveau groupe de packages.
Si vous n'effectuez pas cette opération, l'installation
échoue et il en résulte un conflit de fichiers. Tel est le cas lorsqu'une fenêtre d'erreur intitulée Installation
Failed apparaît, avec les détails suivants :
Installation failed.
Error during "install" phase:
Failed to extract zip standard 1.0.1.I20081018-1820. File
D:\JazzTeamServer\server\license-update-site\site.xml already exists.
Si cela se produit, ce n'est pas fatal ; vous pouvez redémarrer l'installation
et créer correctement un nouveau groupe de packages.
Mises à jour de la configuration de WebSphere Application Server
Les
étapes ci-après sont requises pour configurer correctement WebSphere Application
Server dans Rational Team Concert 2.0.
- Vérifiez que les groupes de correctifs les plus récents de WAS et WASDK
sont installés.
Si vous effectuez un déploiement dans WAS 7.0, il est important
qu'au moins WebSphere Application Server 7.0.0.3 soit installé.
- Supprimez les anciennes propriétés personnalisées de la machine JVM :
- com.ibm.team.repository.provision.profile
- com.ibm.team.server.configURL
- log4j.configuration
- Ajoutez la nouvelle propriété JVM personnalisée JAZZ_HOME
et affectez-lui la valeur suivante :
file:///<JazzInstallDir>/server/conf
- Vérifiez que le paramètre de sécurité WAS "Utiliser les données
d'authentification disponibles quand un URI non protégé est accédé" est coché. Si vous utilisez WAS Integrated Solutions Console, vous pouvez procéder comme
suit :
- Accédez à Sécurité -> Administration, applications et infrastructure
sécurisées -> Sécurité Web - Paramètres généraux.
- Cochez la case "Utiliser les données d'authentification disponibles quand
un URI non protégé est accédé".
Copie des fichiers de configuration requis
à partir d'une installation de serveur précédente
Copiez les fichiers suivants à partir
du serveur source vers le serveur cible. Pour commencer, renommez les fichiers originaux dans
l'installation sur le serveur mis à niveau pour créer des sauvegardes. Si vous
avez utilisé IBM Installation Manager pour mettre à jour la version 1.0, 1.0.1
ou 1.0.1.1 vers la version 2.0, un répertoire de sauvegarde contenant les
fichiers de configuration 1.0.x a été créé, sous un nom tel que
backup-config-horodatage dans le
sous-répertoire du serveur de l'emplacement de l'installation.
Si vous effectuez une mise à niveau vers l'édition Standard ou Enterprise, et que vous avez
acheté le Developer Client Activation Kit pour l'édition Express, achetez et
installez le Developer Client Activation Kit pour l'édition Standard ou Enterprise, pour
pouvoir utiliser ces licences client. Vos affectations de la licence Developer sont toujours valables, mais
les licences Developer seront désactivées jusqu'à ce que le bon kit d'installation soit installé.
Installation des clés d'activation 2.0
La
version 2.0 utilise les clés d'activation 2.0. Si un serveur est migré de la
version 1.0.x.x vers la version 2.0, il repasse à une licence provisoire après
la mise à niveau et vous devez vous procurer les clés d'activation 2.0
auprès de Passport Advantage.
Ci-dessous, les noms des clés appropriées à chaque kit :
- IBM Rational Team Concert Express Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_express_release.jar)
- IBM Rational Team Concert Express Edition - Developer Client License Activation Kit V2.0 Multiplatform (rtc_express_developer_unlocked.jar)
- IBM Rational Team Concert - Contributor Client License Activation Kit V2.0 Multiplatform (rtc_all_contributor_unlocked.jar)
- IBM Rational Team Concert Standard Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_standard_release.jar )
- IBM Rational Team Concert Developer Client License Activation Kit V2.0 Multiplatform (rtc_standard_developer_unlocked.jar)
- IBM Rational Team Concert Floating Developer Client License Activation Kit V2.0 Multiplatform (rtc_standard_floating_developer_unlocked.jar)
- IBM Rational Team Concert - Floating Contributor Client License Activation Kit V2.0 Multiplatform (rtc_standard_floating-developer_unlocked.jar)
- IBM Rational Team Concert Enterprise Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_enterprise_release.jar )
Définition d'une chronologie
Dans Rational Team Concert 1.x,
les projets pouvaient posséder plusieurs chronologies (précédemment
appelées "lignes de développement") et toutes ces chronologies étaient
considérées comme égales.
Dans Rational Team Concert 2.0,
les projets peuvent toujours posséder plusieurs chronologies, mais l'une
d'elles peut être marquée comme "chronologie du projet". Lorsque vous migrez
votre base de données vers la version 2.0, la chronologie principale du projet
n'étant pas connue, aucune chronologie de projet n'est définie pour vos
projets. Vous pouvez mettre à jour manuellement vos projets pour définir la
chronologie de projet, une fois que vous avez migré vers la version 2.0
Configuration de l'instantané du contrôle des sources
L'instantané
SCM (Source Control Management) de l'entrepôt de données collecte
les données sur les flux et notamment les informations sur la taille de ses flux
et de son activité (ensembles d'artefacts modifiés et modifications de
fichier/dossier). Dans la version
1.0, cet instantané collectait automatiquement des informations sur tous les
flux.
Cette opération pouvant s'avérer coûteuse, dans la version 2.0, les
options de possibilité de configuration sont ajoutées à l'instantané SCM
pour laisser les utilisateurs décider des flux dont les données doivent être
collectées. Par conséquent, à moins que vous ne le configuriez, les données
ne seront pas collectées.
Pour
configurer l'instantané SCM, procédez comme suit :
- Vous devez disposer des droits d'écriture sur le flux dont vous
souhaitez collecter les données.
- Accédez à la page Rapports dans l'interface
graphique Web.
- Dans le panneau de navigation de gauche, sélectionnez Administrer l'image instantanée
SCM. Une liste de flux s'affiche.
- Cochez les cases d'un ou plusieurs flux, puis sélectionnez Sauvegarder les modifications.
Les
données des flux sélectionnés seront collectées dans tous les instantanés
ultérieurs.
Modifications incompatibles apportées aux rapports BIRT
Si
vous avez utilisé le concepteur de rapport BIRT pour créer vos propres modèles
de rapport, vous pouvez rencontrer un ou plusieurs incidents lorsque vous
essayez d'utiliser ces rapports dans la version 2.0. Notez bien les points
suivants :
- Modifications de l'ordre dans lequel les classes Java et JavaScript
sont résolues. Si vous avez écrit dans votre rapport BIRT du code JavaScript
qui utilise l'instruction importPackage() pour importer le
package java.lang, sachez que les références non qualifiées à
un objet du code, qui faisaient référence à la classe Java, peuvent maintenant
faire référence à la classe JavaScript (et ne fonctionneront donc pas
correctement). Les autres classes qui portent le même nom dans JavaScript et
Java, telles que java.util.Date, peuvent rencontrer le même
problème. Vous devez donc qualifier intégralement votre référence à la classe
Java et supprimer l'instruction importPackage().
- Modifications apportées au traitement des fichiers. Auparavant, le simple
fait d'associer un élément (tel qu'un libellé) à un fichier, entraînait le
traitement intégral de ce fichier lorsque l'élément était affiché. Cela était
pratique car il était ainsi possible d'appliquer un classement au traitement
des fichiers à l'aide de libellés (masqués) associés aux fichiers selon leur
ordre de traitement. Désormais, une telle association
ne traite que la première ligne du fichier. Pour retrouver le comportement
précédent, utilisez un élément de texte dynamique et appelez un code JavaScript
qui force le traitement de l'intégralité du fichier. Vous
pouvez par exemple utiliser Total.count().
- Les bogues du concepteur de rapport BIRT peuvent être à l'origine d'une
perte de données. Ces incidents apparaissent lorsque vous ouvrez un fichier de
conception de rapport BIRT créé dans BIRT 2.2.2
(RTC 1.0) avec le concepteur de rapport BIRT 2.3.2 (RTC 2.0).
Les incidents suivants ont été observés :
- Lors de l'édition d'un fichier pour la première fois à l'aide de BIRT
2.3.2, dans la page "Paramètres", la zone "Valeur par défaut" et celle
des paramètres du rapport risquent d'être perdues. La solution consiste à ressaisir les valeurs ou à
copier, puis coller les valeurs d'une version précédente de l'éditeur. Une
fois que vous avez sauvegardé le fichier avec les nouvelles valeurs entrées,
l'incident ne se reproduit plus.
- Lors de l'édition d'un fichier de conception de rapport pour la première
fois à l'aide de BIRT 2.3.2, la valeur par défaut des paramètres de rapport
risque d'être perdue. Cela peut également se produire après l'incident décrit précédemment. La solution consiste à ressaisir les valeurs ou à copier, puis coller les
valeurs d'une version précédente de l'éditeur. Une fois que vous avez
sauvegardé le fichier avec les nouvelles valeurs entrées, l'incident ne se
reproduit plus.
Ces incidents peuvent être assez graves s'ils ne
sont pas détectés car les données collectées par le rapport risque d'être
incorrectes. Il est recommandé de vérifier chaque fichier et chaque paramètre
de rapport lors de l'édition d'un rapport pour la première fois à l'aide du
concepteur de rapport de BIRT 2.3.2. Ces incidents ne se produisent pas pour
les nouveaux rapports créés à l'aide des outils de BIRT 2.3.2.
Les
modifications ci-dessus sont apportées à tous les rapports Rational Team Concert 2.0
prêts à l'emploi ; aucune intervention n'est requise de votre part. Toutefois,
si vous avez créé des modèles de rapport manuellement dans votre zone
de projet à l'aide de nos rapports prêts à l'emploi et que vous n'avez pas
spécifié d'identificateur approprié (qui respecte notre syntaxe), votre
modèle de rapport ne sera pas régénéré lors de sa migration. Le contenu sera
donc obsolète et ne fonctionnera pas. Dans ce cas, vous devez télécharger le
nouveau contenu des modèles affectés, à l'aide du fichier
.rptdesign prêt à l'emploi approprié.
Importation des données des éléments de travail dans l'entrepôt de données
Dans Rational Team Concert
2.0, plusieurs modifications de schéma ont été apportées aux tables des
éléments de travail de l'entrepôt de données. En conséquence, lors de la
migration de la version 1.0 vers la version 2.0, l'importateur ignore les
données des éléments de travail entreposés. Par conséquent, lorsque vous
démarrez le serveur 2.0 pour la première fois, vos rapports d'éléments de
travail risquent de ne pas fonctionner correctement. La solution consiste à
attendre que l'instantané des éléments de travail soit exécuté pour la première
fois ou à l'exécuter manuellement après le démarrage du serveur. Lors de la
première exécution après la migration, l'instantané des éléments de travail
reconstitue l'intégralité des informations historiques sur les éléments de
travail dans l'entrepôt de données. Cela signifie également que la première
exécution de l'instantané après la migration risque de durer bien plus qu'une
exécution nocturne standard.
Détection des nouveaux rapports
Dans Rational Team Concert 2.0,
plusieurs rapports ont été ajoutés. Ces rapports apparaissent dans les
nouveaux modèles de processus livrés avec le produit, mais ils ne sont pas
automatiquement ajoutés aux zones de projet existantes lors de la migration. Nous
avons ajouté une nouvelle action qui vous permettra de détecter et déployer ces
nouveaux modèles de rapport dans vos zones de projet existantes après la
migration. Pour déployer les
nouveaux modèles de rapport, procédez comme suit :
- Sur le client enrichi, ouvrez la vue Artefacts de
l'équipe.
- Développez votre zone de projet et Rapports.
- A l'aide du bouton droit de la souris, cliquez sur Modèles de rapport et sélectionnez Déployer
de nouveaux modèles.
La boîte de dialogue permet
de détecter les modèles de rapport qui sont disponibles, mais qui ne sont pas
encore déployés dans votre zone de projet.
Vous pouvez en sélectionner un ou plusieurs, qui seront créés. Une fois que
ces modèles ont été créés, vous pouvez créer des rapports à partir de ces
modèles à l'aide des actions de menu disponibles.
Personnalisations
Les modifications que vous
apportez aux types d'élément de travail, attributs, flux de travaux,
rôles et gestionnaires d'événements sont conservées lorsque vous migrez de
la version 1.x vers la version 2.0. Si vous avez personnalisé un modèle de
processus prédéfini (tel que Scrum), sachez que si vous redéployez le modèle
prédéfini (dans la vue Modèles de processus), vous écrasez vos
personnalisations. Si vous devez redéployer le modèle prédéfini, vous devez
d'abord modifier le nom et l'ID du modèle prédéfini que vous avez personnalisé
pour qu'il ne soit pas écrasé.
Présentation de l'installation des éditions Standard et Enterprise
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 Workgroup Server, DB2 ou Oracle.
DB2 Workgroup Server est inclus dans les modules d'installation
des éditions Enterprise, 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 Workgroup Server est disponible sur le même site que celui de Rational Team Concert.
Une fois installé DB2 Workgroup Server, 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 ou Enterprise
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 de Standard Edition ou Enterprise 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 ou Enterprise Edition à l'aide d'IBM Installation
Manager.
- 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.
- 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 Workgroup Server.
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 l'édition DB2 Workgroup Server regroupée.
Si vous installez DB2 Workgroup Server, 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 Build
System Toolkit.
- Facultatif : installez ClearCase Connector .
- Facultatif : installez 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 :
- Création d'une base de données.
- Configuration des fichiers de propriétés.
- Création des tables de base de données.
Si vous utilisez des éditions de DB2 prises en charge, 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.
Si vous utilisez SQL Server, passez à la section Configuration d'une base de données de serveur SQL.
Configuration d'une base de données DB2
Configurez une base de données DB2 prise en charge ou la base de données DB2 Workgroup
Server regroupée pour utiliser 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 :
- 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.
Remarque :
Pour garantir le traitement correct du contenu Unicode, le jeu de caractères de la base de données doit être UTF-8. La table AUDITABLE_LINKS
dépassant la taille de page par défaut de 4 ko sous Windows, choisissez une taille de page supérieure ou égale à 8 ko.
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/conf/jazz
te renommez-le teamserver.derby.properties.
- Recherchez le fichier teamserver.db2.properties dans le répertoire
JazzInstallDir/server/conf/jazz
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.
- Recherchez les lignes suivantes :
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
- 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).
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 sur DB2 et Oracle.
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.
- 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.
Conseil :
Lors de l'installation d'Oracle, vous avez la possibilité de créer automatiquement une base de données.
Important :
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.
A faire :
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
Important :
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 que l'utilisateur a été créé, vous devez lui octroyer les droits
nécessaires pour qu'il puisse initialiser la base de données Jazz. Les
commandes SQL suivantes permettent d'octroyer les droits appropriés :
GRANT CREATE SESSION TO jazzDBuser;
GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
GRANT CREATE PROCEDURE TO jazzDBuser;
GRANT CREATE VIEW TO jazzDBuser;
- Recherchez le fichier teamserver.properties dans le
répertoire JazzInstallDir/server/conf/jazz
et renommez-le teamserver.OtherDBProvider.properties.
- Recherchez le fichier teamserver.oracle.properties dans le répertoire
JazzInstallDir/server/conf/jazz
et renommez-le teamserver.properties.
Conseil :
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.
- Configurez le serveur
- 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 Oracle 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/conf/jazz et changez les informations mentionnées ci-dessous en fonction de votre configuration.
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Remplacez jazzDBuser par l'utilisateur créé pour Jazz pour utiliser la base de données Oracle. Si vous utilisez localhost, supprimez la mise en commentaire de cette ligne en
supprimant le caractère # au début de la ligne et en mettant en commentaire la prochaine ligne d'emplacement. Les chaînes de connexion localhost ne doivent pas être précédées de //. Remplacez la valeur 1521 par celle du port TCIP de votre serveur Oracle. Remplacez ORCL par le nom de votre base de données Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
Si vous utilisez une connexion autre que localhost, supprimez la mise en
commentaire de cette ligne en supprimant le caractère # au début de la ligne et
en mettant en commentaire la ligne d'emplacement précédente. Les chaînes de connexion autres que localhost doivent être précédées de //.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Remplacez jazzDBpswd par le mot de passe de l'utilisateur créé pour Jazz pour utiliser la base de données Oracle.
Important :
Ne modifiez pas le texte {password} dans la propriété com.ibm.team.repository.db.jdbc.location.
Le mot de passe de l'utilisateur doit être spécifié dans la propriété com.ibm.team.repository.db.jdbc.password.
Si vous utilisez Oracle Express, utilisez 1521 pour le port TCIP et XE comme nom de base de données Oracle :
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.password=jazzDBpswd
-
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.
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 sur DB2 et Oracle.
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 :
- Un serveur SQL est installé
- Le service SQL Server est démarré
- Les pilotes JDBC du serveur SQL sont installés. Pour plus d'informations,
voir http://msdn2.microsoft.com/en-us/data/aa937724.aspx
- Le protocole TCP est activé pour le serveur SQL
- L'utilisateur qui crée la table de base de données soit disposer des droits d'accès suivants :
- Membre du rôle serveur fixe sysadmin ou propriétaire de la base de données (dbo)
A faire :
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
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
A faire :
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/conf/jazz/teamserver.properties en
teamserver.OtherDBProvider.properties
- Renommez le fichier teamserver.sqlserver.properties en teamserver.properties
Conseil :
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/conf/jazz 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
Important :
Ne modifiez pas le texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
Le mot de passe de l'utilisateur doit être spécifié dans la propriété com.ibm.team.repository.db.jdbc.password.
Pour spécifier l'emplacement du fichier Jar de JDBC, procédez comme suit :
- Dans le même répertoire que les scripts de serveur (JazzInstallDir/server), créez un répertoire nommé
sqlserver.
- 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. Copiez le fichier dans le répertoire sqlserver nouvellement créé.
- Indiquez l'emplacement du fichier JDBC JAR pour JDBC en exécutant la tâche
suivante :
- Configurez la variable d'environnement SQLSERVER_ABSPATH pour
pointer sur le répertoire contenant le fichier JAR. Si le chemin d'accès contient des espaces, vous devez le placer entre guillemets.
Conseil :
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.
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 sur DB2 et Oracle.
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 :
- 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 sur DB2 et Oracle
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.
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 :
DB2 uniquement.
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 serveur 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.
- 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/conf/jazz/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/logs
contient les fichiers journaux du serveur. Consultez-les si vous avez des difficultés à démarrer le serveur.
- Le fichier JazzInstallDir/server/tomcat/conf/server.xml
contient les paramètres SSL qui spécifient un algorithme uniquement disponible
dans l'environnement JRE IBM. Pour exécuter le serveur avec un environnement
JRE Sun, dans le fichier server.xml, modifiez les paramètres de
Connector port="9443", de sorte que sslProtocol="TLS" au lieu de "SSL".
Supprimez également le paramètre d'algorithme.
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.
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
- 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/logs/jazz.log.
- 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 serveur 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 :
- 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.
- Vérifiez que le paramètre de sécurité WAS "Utiliser les données
d'authentification disponibles quand un URI non protégé est accédé" est coché. Si vous utilisez WAS Integrated Solutions Console, vous pouvez procéder comme
suit :
- Accédez à Sécurité -> Administration, applications et infrastructure sécurisées -> Sécurité Web - Paramètres généraux.
- Cochez la case "Utiliser les données d'authentification disponibles quand
un URI non protégé est accédé".
- 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/tomcat/webapps/jazz.war.
- le répertoire JazzInstallDir/server/update-site.
- le répertoire JazzInstallDir/server/conf.
- la base de données de référentiel par défaut dans JazzInstallDir/repositoryDB.
- les outils de référentiel dans JazzInstallDir/repotools.
- le répertoire JazzInstallDirserver/license-update-site.
- le répertoire JazzInstallDir/server/nl1-update-site.
- le répertoire JazzInstallDir/server/nl2-update-site.
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.
- 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:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
Remarque :
Il s'agit d'un exemple de configuration de DB2. Le fichier teamserver.properties doit être mis à jour en fonction du fournisseur de base de données (Oracle/MS-SQL).
- 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 ou WebSphere Application Server version 7.0
avec au moins la version 7.0.0.3. 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.
Vous devez vous procurer les correctifs Internet WebSphere Application
Server des correctifs d'IBM Java SDK 1.5 SR9 ou IBM Java SDK 1.6 SR4
nécessaires pour qu'IBM Rational Team Concert
2.0 fonctionne correctement. Si vous ne le faites pas, certains services du
serveur risquent de ne pas démarrer correctement. Les correctifs Internet
sont disponibles sous les correctifs APAR WebSphere Application Server
correspondants. Pour IBM Java SDK 1.5/WebSphere Application Server 6.1, le
correctif APAR est PK85942 et vous pouvez télécharger les fichiers à partir du
site suivant : ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/.
Installez
au moins WebSphere Application Server 6.1 Fix Pack 19 avant d'installer le
correctif Internet de l'environnement JRE. Pour IBM Java SDK 1.6/WebSphere
Application Server 7.0, le correctif APAR est PK 86771 et vous pouvez
télécharger les fichiers à partir du site suivant : ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.
- 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 certains fichiers de configuration. Pour cela, la propriété système JAZZ_HOME doit être définie. Cette propriété utilise 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 ou SQL Server, vous devez ajouter une propriété appelée "ORACLE_JDBC" ou "SQLSERVER_JDBC". Attribuez à la propriété le chemin d'accès absolu
au fichier (par l'URL) des pilotes de périphérique JDBC appropriés.
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 : java.awt.headless Valeur : true
- Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true
- Nom: JAZZ_HOME Valeur : file:///JazzInstallDir/server/conf
- 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é.
Que faire ensuite
Une fois créé le serveur, passez à la section Exécution de l'assistant de configuration.
Pour plus d'information sur cette rubrique, cliquez sur les liens suivants :
https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-setup/index.html
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ
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/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/conf/jazz/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 :
- com.ibm.team.repository.servlet.internal.ServletConfigurationService
- Port HTTP du référentiel
- Port HTTPS du référentiel
- com.ibm.team.repository.service.internal.webuiInitializer.ConfigPropertyInitializer
- Port HTTP de l'URL
- Port HTTPS de l'URL
- 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.
- 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 :
- 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.
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.
- 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
Build
System Toolkit
pour lancer le processus d'installation.
- Une fois l'installation terminée, vous pouvez configurer une génération. Plus d'informations relatives à
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
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.
- 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
ClearCase Connector
pour lancer le processus d'installation.
- A l'issue de l'installation, configurez ClearCase Connector . Voir
Déploiement de
ClearCase Connector .
Installation de Rational Team Concert
ClearQuest Connector à l'aide
d'IBM Installation Manager
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.
- 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
ClearQuest Connector
pour lancer le processus d'installation.
- A l'issue de l'installation, configurez ClearQuest Connector . Voir
Déploiement de
ClearQuest Connector .
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 :
chcon -R -t textrel_shlib_t /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre
-
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.
- IBM Installation Manager :
- /opt/IBM/InstallationManager/eclipse/jre_5.0.2.sr5_20070511/jre
- Jazz Team Server:
- /opt/IBM/JazzTeamServer/server/linux/ibm-java2-i386-50/jre
- Rational Team Concert - Client: (exécutez chcon sur les 4 répertoires)
- /opt/IBM/TeamConcert/jdk/bin
- /opt/IBM/TeamConcert/jdk/lib
- /opt/IBM/TeamConcert/jdk/jre/bin
- /opt/IBM/TeamConcert/jdk/jre/lib
- Rational Team Concert - Build
System Toolkit:
- non disponible (aucun JRE inclus)
- Rational Team Concert - ClearCase Connector : (exécutez chcon sur les 4 répertoires)
- /opt/IBM/ClearCaseConnector/jdk/bin
- /opt/IBM/ClearCaseConnector/jdk/lib
- /opt/IBM/ClearCaseConnector/jdk/jre/bin
- /opt/IBM/ClearCaseConnector/jdk/jre/lib
- Rational Team Concert - ClearQuest Connector :
- /opt/IBM/ClearQuestConnector/gateway/linux/ibm-java2-i386-50/jre