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. Les instructions reposent sur WebSphere Application
Server version 6.1.0.23. Il existe de légères différences pour la version 7.0.0.7 et les versions ultérieures. Ces différences sont précisées dans le texte, le cas échéant.
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 ses paramètres ont été utilisés pour mettre à jour le fichier teamserver.properties.
- Activation de la connexion tenant compte de la casse (facultatif) : si la méthode d'authentification du serveur d'applications permet d'utiliser les connexions tenant compte de la casse, vous pouvez indiquer à l'application Jazz de les accepter également. Vous pouvez activer cette fonction via la propriété "Utiliser la correspondance des ID utilisateur sans respect de la casse" dans la page des propriétés avancées de l'interface utilisateur Web d'administration. Le paramètre par défaut ne change pas ; les administrateurs doivent changer explicitement cette propriété pour activer la fonction.
- L'option Sécurité Java™ 2 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. (Dans WAS 7.0.0.7,
accédez à Sécurité -> Sécurité globale -> Web et sécurité SIP -> 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
le nomment 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 pour installer Jazz Team
Server afin
de l'utiliser avec Rational Team Concert,
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 sous Windows® ou
/opt/IBM/JazzTeamServer sous 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 le centre de documentation 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.
Procédure
- 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.7. 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. Le correctifs sont disponibles dans les 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
ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/.
Installez au minimum le groupe de correctifs WebSphere Application
Server 6.1 Fixpack 19 avant d'installer le correctif 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
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.
La première propriété à définir dans les arguments JVM génériques est la valeur d'allocation de mémoire maximale
par défaut, à 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 la valeur -Xmx1536M, en fournissant une mémoire instantanée de 1 536 Mo au processus Jazz Team
Server.
Une seconde propriété à définir dans les arguments JVM génériques,
spécifiquement pour Rational Quality Manager,
est la taille de la pile de l'unité d'exécution. Une taille de pile standard pour Rational Quality Manager est -Xss786K.
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.
Les exemples ci-après illustrent les arguments JVM génériques permettant de se connecter aux bases de données Oracle et SQL Server, avec la valeur d'allocation de mémoire maximale
par défaut et la taille de la pile de l'unité d'exécution. Remplacez JazzInstallDir par
le répertoire de votre installation Jazz Team
Server.
-DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k
Plusieurs autres propriétés système doivent être définies pour contrôler
certains comportements du serveur. Ces propriétés sont incluses ci-après. Voici les
caractéristiques de définition de ces propriétés JVM dans la console d'administration WebSphere Administrative
Console. Remplacez JazzInstallDir par
le répertoire de votre installation Jazz Team
Server :
- Cliquez sur .
- Cliquez sur server1.
- Cliquez sur .
- 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 Serveurs d'applications > {nom_serveur} > Définition des processus > Machine virtuelle Java > Propriétés personnalisées. L'une des propriétés personnalisées que vous devez ajouter est JAZZ_HOME,
une propriété système qui indique l'emplacement de certains fichiers de configuration. 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.
- 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.
- Ouvrez la console d'administration de WebSphere Application Server.
- Cliquez sur . (Pour WebSphere Application Server
7.0.0.7 et les versions ultérieures, cliquez sur . )
- 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/tomcat/webapps/jazz.war
- Attribuez la valeur /jazz à Racine du contexte, puis cliquez sur Suivant.
Remarque : Cette étape apparaît vers la fin de l'installation dans WebSphere Application Server 7.0.0.7 et
les versions ultérieures.
- Cliquez sur Suivant et reprenez l'étape Installation d'une nouvelle application restante.
- Cliquez sur Terminer.
- Vérifiez que l'application jazz_war a été installée et cliquez sur Sauvegarder directement dans la configuration principale.
- Cliquez sur .
- 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é.
Remarque : Les étapes restantes ne s'appliquent qu'à Rational Quality Manager.
- Vous êtes renvoyé à la page Installation d'une nouvelle application.
- Recherchez l'emplacement du fichier help.war dans le système de fichiers local et sélectionnez-le. Entrez la racine de contexte sous la forme /help et cliquez sur Suivant.
Remarque : Le fichier help.war se trouve dans répertoire_installation_Jazz\server\tomcat\webapps\help.war.
- Cliquez de manière répétée sur Suivant jusqu'à ce que l'écran de récapitulatif s'affiche et cliquez ensuite sur Terminer pour installer la nouvelle application.
- Vérifiez que l'application help_war a été installée et cliquez sur Sauvegarder pour sauvegarder les modifications dans le fichier de configuration maîtresse.
- Cliquez sur .
- Sélectionnez help_ war et cliquez sur Démarrer.
Que faire ensuite
Une fois créé le serveur, passez à la section
Exécution de l'assistant de configuration.
Pour plus d'informations sur cette rubrique, cliquez sur les liens suivants :
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ