Configuration d'un WebSphere Application Server

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

Avant de commencer

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

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.
Par exemple,
- Remplacez cette ligne :
```
url=file:./update-site
```
- par quelque chose comme
```
url=file:/opt/IBM/JazzTeamServer/server/update-site
```
Remarque : Le répertoire JazzInstallDir/server/provision_profiles/ doit uniquement contenir les fichiers .ini inclus et ne doit contenir aucun fichier de sauvegarde. Certains éditeurs sauvegardent automatiquement un fichier de sauvegardes qui doit être supprimé.

Examinez et mettez à jour l'emplacement de la base de données du fichier teamserver.properties

com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin

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 :
1. Cliquez sur Serveurs > Serveurs d'applications.
2. Cliquez sur server1.
3. Cliquez sur Gestion des processus et Java > Définition des processus.
4. Cliquez sur Machine virtuelle Java.
5. Ajoutez la valeur 100 dans la zone Initial Heap (Segment mémoire initial).
6. Ajoutez la valeur 1000 dans la zone Taille maximum de la pile.
7. Cliquez sur Appliquer.
8. Cliquez sur Logging and Tracing (Consignation et traçage). Cliquez sur Change Log Detail Levels (Modifier les niveaux de détails du journal). Le Jazz Team Server utilise le moteur de génération de rapports BIRT. Pour empêcher que les entrées d'information BIRT ne soient écrites dans le fichier journal WebSphere, définissez le niveau de consignation des modules org.eclipse.birt.* sur grave. Cliquez sur Appliquer.
9. Cliquez sur Propriétés personnalisées
10. Ajoutez les propriétés suivantes : Cliquez sur Nouveau, entrez le Nom et la Valeur, puis cliquez sur OK.
  - Nom : com.ibm.team.repository.provision.profile Valeur : file:///JazzInstallDir/server/provision_profiles (comme l'URL du fichier)
    Remarque : La propriété com.ibm.team.repository.provision.profile doit point vers le répertoire contenant les provision_profiles.
  - Nom : com.ibm.team.server.configURL Valeur : file:///JazzInstallDir/server/teamserver.properties (comme l'URL du fichier)
  - Nom : log4j.configuration Valeur : file:///JazzInstallDir/server/log4j.properties (comme l'URL du fichier)
  - Nom : java.awt.headless Valeur : true
  - Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true
11. Cliquez sur Sauvegarder directement dans la configuration principale.
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
```
1. Ouvrez la console d'administration de WebSphere Application Server.
2. Cliquez sur Applications > Installation d'une nouvelle application.
3. Sous Chemin d'accès, cliquez sur Chemin d'accès au système de fichiers local.
4. Sous Chemin d'accès complet, entrez :
```
JazzInstallDir/server/jazz.war
```
5. Attribuez la valeur /jazz à Racine du contexte.
6. Cliquez sur Suivant et reprenez l'étape Installation d'une nouvelle application restante.
7. Cliquez sur Terminer.
8. Cliquez sur Sauvegarder directement dans la configuration principale.
9. Cliquez sur Applications > Applications d'entreprise.
10. Cochez la case en regard de jazz_war, puis cliquez sur Démarrer.
  Une flèche verte apparaît et indique que l'application a bien démarré.

Que faire ensuite

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