Cette rubrique explique comment configurer Jazz Team Server
for System z pour qu'il fonctionne avecWebSphere 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 for System z 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 for System z, 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 for System z .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 :
- 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 for System z 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 for System z que vous placez dans un répertoire de votre
machine serveur WebSphere. Dans les instructions à venir, celui-ci est appelé répertoire d'installation de Jazz Team Server for System z ou répInstallJazz en abrégé. A partir de ce répertoire, utilisez :
- Le fichier répInstallJazz/server/tomcat/webapps/jazz.war.
- Le répertoire répInstallJazz/server/update-site.
- Le répertoire répInstallJazz/server/conf.
- La base de données du référentiel par défaut dans répInstallJazz/repositoryDB.
- Les outils de référentiel dans répInstallJazz/repotools.
- Le répertoire répInstallJazz/license-update-site.
- Le répertoire répInstallJazz/server/nl1-update-site.
- Le répertoire répInstallJazz/server/nl2-update-site.
Pourquoi et quand exécuter 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 au
centre de documentation WebSphere
et recherchez
Sécurisation des applications et de leur environnement.
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. Voir Detailed System Requirements for the Rational Team
Concert for System z server environments.
- Mettez à jour les arguments JVM.
Jazz Team Server for System z 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 for System z 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 for System z.
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 dansWebSphere Administrative
Console. Remplacez répInstallJazz par votre répertoire d'installation Jazz Team Server for System z :
- 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 Journalisation et traçage. Cliquez sur Modification des niveaux de détail de journalisation. Jazz Team Server for System z 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:///répInstallJazz/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,
répInstallWAS 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 .
- Sous Chemin d'accès, cliquez sur Chemin d'accès au système de fichiers local.
- Sous Chemin d'accès complet, entrez :
répInstallJazz/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 .
- 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é.