Configuration de WebSphere Application Server for Rational Engineering Lifecycle Manager

Le déploiement et le démarrage de Jazz Team Server commence par la sélection du serveur d'applications qui héberge Jazz Team Server et ses applications. Pour pouvoir déployer les fichiers WAR des applications Rational Engineering Lifecycle Manager, vous devez configurer WebSphere Application Server.

Avant de commencer

Vérifiez que vous avez effectué les tâches suivantes :

L'interface Web Jazz requiert de configurer l'authentification afin de procéder aux autorisations et de personnaliser l'application.

Remarque :
  • Rational Engineering Lifecycle Manager v1.x doit partager un serveur d'applications avec Lifecycle Query Engine.
  • Rational Engineering Lifecycle Manager v4.x peut partager un serveur d'applications avec Lifecycle Query Engine ou être déployé sur un autre serveur d'applications. Toutefois, les deux applications doivent être enregistrées sur le même serveur Jazz Team Server.

Pourquoi et quand exécuter cette tâche

Ce document ne fournit pas de détails sur la configuration de 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 sont présentées dans le centre de documentation de WebSphere Application Server. Pour plus d'informations, accédez au centre de documentation WebSphere et lancez une recherche sur la phrase suivante : Sécurisation d'applications et de leur environnement.

Procédure

  1. Rational Engineering Lifecycle Manager nécessite plusieurs paramètres spécifiques dans la machine virtuelle Java dans laquelle il s'exécute. Pour définir ces propriétés, dans la console WebSphere Integrated Solutions, cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > Serveur1.
  2. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition des processus.
  3. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
  4. Ajoutez la valeur 4096 à la zone Taille de pile initiale.
  5. Ajoutez la valeur 24576 dans la zone Taille de pile maximale.
    Conseil : L'exemple présenté ici n'est qu'une suggestion et vous devez définir la valeur en fonction de votre environnement. Une équipe de taille moyenne peut utiliser la valeur 4 096 Mo en fournissant un segment de mémoire de 4 Go au processus Rational Engineering Lifecycle Manager sur un ordinateur 64 bits. Si la valeur Taille de pile maximale est trop petite, il se peut que la source de données Rational Engineering Lifecycle Manager vers le moteur LQE (Lifecycle Query Engine) arrête de traiter le backlog existant et toute modification visant à créer, modifier ou supprimer des produits.

    Il est également important de disposer de plus de mémoire physique que ce qui est requis par l'ensemble combiné des processus s'exécutant sur la machine afin d'empêcher la pagination ou la permutation. La pagination réduit les performances du système et affecte celles du système de gestion de la mémoire Java.

    Lorsque vous augmentez la taille du segment de mémoire Java, veillez à ce que la mémoire physique inutilisée sur votre ordinateur soit suffisante pour prendre en charge l'augmentation. Si la mémoire physique disponible n'est pas suffisante, vous devez soit installer de la mémoire supplémentaire, soit tenir compte de l'effet sur l'ensemble des performances qui se produit en conséquence.

  6. Dans la zone Arguments JVM génériques, entrez la ligne suivante :
    Windows :
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux :
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Conseil : Si vous voulez utiliser un segment de mémoire plus grand, utilisez le paramètre suivant en remplaçant {N} par la quantité de mémoire à utiliser et {N/8} par 1/8 de la mémoire totale. Par exemple, si -Xmx a la valeur 8g, -Xmn doit avoir la valeur 1g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  7. Cliquez sur Appliquer, puis sur Sauvegarde dans la configuration principale.
  8. 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 URL et non un simple chemin, vous devez donc indiquer la valeur en tant que style de fichier URL : fichier :///chemin_fichier. Sous machine virtuelle Java > Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
    A faire : Vous devez spécifier trois barres obliques (///) après file: :
    Important : Dans un environnement réparti dans lequel vous utilisez un serveur d'applications distant, vous devez ajouter les propriétés personnalisées suivantes pour chaque instance de WebSphere Application Server.
  9. Cliquez sur Nouvelle, entrez JAZZ_HOME dans la zone Nom et file:///Rép_install_Jazz/server/conf dans la zone Valeur. Remplacez Rép_install_Jazz par le répertoire d'installation de Jazz Team Server. Par exemple, entrez file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf sous Windows ou file:///opt/IBM/JazzTeamServer/server/conf sous Linux.
    Remarque : Pour éviter des problèmes, n'insérez pas d'espaces dans les chemins. Pour le répertoire Program Files, vous pouvez utiliser PROGRA~1, et pour le répertoire Program Files (x86), vous pouvez utiliser PROGRA~2.
  10. Cliquez sur OK.
  11. Répétez l'étape 10 et ajoutez les propriétés personnalisées suivantes :
    • Nom : java.awt.headless Valeur : true
    • Nom : org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valeur : true
    • Si vous vous connectez à une base de données Oracle, Nom : ORACLE_JDBC_DRIVER_FILE Valeur : Chemin absolu d'accès au pilote JDBC/ojdbc6.jar
      Remarque : Le chemin d'accès au pilote JDBC doit être un chemin absolu. N'utilisez pas de chemin URL (fichier:///). Pour plus d'informations sur les connexions Oracle Java Database Connectivity (JDBC), voir Configuration d'une base de données Oracle pour Rational Engineering Lifecycle Manager et Lifecycle Query Engine
    • Nom : log4j.configuration Valeur : fichier:///RépInstallJazz/server/conf/startup_log4j.properties
      Remarque : Les paramètres figurant dans le fichier startup_log4j.properties sont utilisés au début du processus de démarrage pour transmettre des messages au fichier SystemOut.log de WebSphere Application Server. Ensuite, chaque application Jazz utilise les paramètres propres à l'application provenant du fichier RépInstallJazz/server/conf/contexte app/log4j.properties.
  12. Cliquez sur Sauvegarde dans la configuration principale.
  13. Augmentez la taille du pool d'unités d'exécution par défaut pour autoriser la présence de plusieurs utilisateurs simultanés. Cliquez sur Serveurs > Types de serveur > Serveurs d'applications WebSphere > Server1.
  14. Sous Propriétés supplémentaires, cliquez sur Pools d'unités d'exécution.
  15. Cliquez sur WebContainer et faites passer la taille maximale par défaut de 50 à 200 unités d'exécution.
  16. Cliquez sur Sauvegarde dans la configuration principale.
  17. Cliquez sur Serveurs > Types de serveur > Serveurs d'applications > Serveur1 > Gestion de session > Propriétés personnalisées. Dans la page Propriétés personnalisées, cliquez sur Nouveau.
  18. Dans la page Configuration, entrez InvalidateOnUnauthorizedSessionRequestException dans la zone Nom et entrez true (vrai) dans la zone Valeur. La valeur par défaut pour cette propriété personnalisée de gestion de session est false (faux). Cliquez sur OK ou sur Appliquer.
  19. Cliquez sur Sauvegarder dans la barre des tâches de la console pour sauvegarder les modifications apportées à la configuration.
  20. Pour que les modifications soient prises en compte, redémarrez le serveur d'applications.

Que faire ensuite

Après avoir configuré le serveur, vous devez y déployer les fichiers d'application.

  1. A partir de la console d'administration WebSphere Application Server, sélectionnez Applications > Installer une nouvelle application (ou Applications > Nouvelle application > Nouvelle application d'entreprise).
  2. Sous Chemin de la nouvelle application, sélectionnez Système de fichiers local.
  3. Sous Chemin complet, entrez [rép_install_relm]/server/webapps/relm.war
  4. Définissez la racine de contexte /relm
  5. Cliquez sur Suivant, puis continuez avec les étapes Installation d'une nouvelle application restantes, lorsque vous y êtes invité par cet éditeur. Cliquez sur Terminer.
  6. Installez l'application de gestion de configuration (Configuration Management), vvc.war, en utilisant les mêmes étapes que celles décrites précédemment et en utilisant [rép_install_relm]/server/webapps/vvc.war pour le chemin et /vvc comme racine de contexte.
  7. Installez le composant SPARQL Gateway, SPARQL_Gateway.war, en exécutant les mêmes étapes que précédemment, en remplaçant [rép_install_relm]/server/webapps/SPARQL_Gateway.war par le chemin et en utilisant /SPARQL_Gateway comme racine de contexte.
  8. Si vous voulez fournir la documentation depuis le serveur au lieu de permettre son affichage en ligne, vous pouvez également déployer l'application relmhelp.war.
  9. Sélectionnez Sauvegarde dans la configuration principale.
  10. SPARQL Gateway nécessite de changer l'ordre par défaut de chargement des classes.
    1. Sélectionnez Applications > Types d'applications > Applications d'entreprise WebSphere et choisissez SPARQL_Gateway_war dans la liste des applications.
    2. Cliquez sur Chargement de classes et détection des mises à jour.
    3. Dans la section Ordre de chargeur classe, sélectionnez Classes chargées en premier avec un chargeur de classe local(dernier parent)
    4. Cliquez sur OK et Sauvegarder dans la configuration principale.
    5. Sélectionnez Gestion des modules. Sélectionnez le module SPARQL_Gateway.
    6. Recherchez la zone Ordre de chargeur de classe et sélectionnez Classes chargées en premier avec un chargeur de classe local (dernier parent).
    7. Cliquez sur OK et Sauvegarder dans la configuration principale.
  11. Dans la page Applications d'entreprise, sélectionnez les applications que vous venez de déployer sur WebSphere Application Server, puis sélectionnez Démarrer.
Remarque : Ce document ne fournit pas de détails sur la configuration de 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 sont présentées dans le centre de documentation de WebSphere Application Server. Pour plus d'informations, reportez-vous au centre de documentation WebSphere et recherchez l'expression suivante : Sécurisation des applications et de leur environnement (Securing applications and their environment).

Commentaires