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

Important : Si vous effectuez un mise à niveau à partir d'une ancienne version du produit, suivez les instructions de mise à niveau pour configurer votre serveur d'applications.
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 la documentation produit de WebSphere Application Server. Pour plus d'informations, reportez-vous à la documentation produit WebSphere et recherchez l'expression suivante : Sécurisation d'applications et de leur environnement.

Procédure

  1. Configurez la machine virtuelle Java dans laquelle s'exécute Rational Engineering Lifecycle Manager.

    Cliquez sur Serveurs > Types de serveur > Serveurs d'applications WebSphere > Server1. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition des processus. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java. Entrez les valeurs suivantes. Cliquez sur Appliquer, puis sur Sauvegarde dans la configuration principale.

    Tableau 1. Configuration de la machine virtuelle Java
    Champ Valeur Commentaires
    Tas initial 4096  
    Taille maximale du tas 24576
    • 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 4096 Mo, en fournissant une mémoire instantanée de 4 Go au processus Rational Engineering Lifecycle Manager sur un ordinateur 64 bits. Si la taille maximale du tas est trop petite, il se peut que la source de données Rational Engineering Lifecycle Manager vers le moteur Lifecycle Query Engine arrête de traiter le backlog existant et toute modification visant à créer, modifier ou supprimer des produits.
    • Il est essentiel de disposer de plus de mémoire physique que la quantité nécessaire pour tous les processus combinés sur la machine afin d'éviter les opérations de pagination et de 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 tas Java, veillez à ce que la mémoire physique inutilisée sur la machine soit suffisante pour couvrir cette 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.
    Arguments JVM génériques Linux
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Windows
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux
    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
  2. Configurez vos propriétés personnalisées.

    Dans le menu Propriétés supplémentaires, sélectionnez Propriétés personnalisées > Nouvelle. Entrez les informations générales requises pour chacune des propriétés personnalisées suivantes en cliquant à chaque fois sur OK pour les enregistrer. Cliquez ensuite sur Sauvegarde dans la configuration principale.

    Tableau 2. Propriétés personnalisées
    Nom de la propriété personnalisée Valeur de la propriété personnalisée Commentaires
    JAZZ_HOME file:///RépInstallJazz/server/conf

    Remplacez RépInstallJazz par le répertoire d'installation de Jazz Team Server.

    A faire :
    • Vous devez spécifier trois barres obliques (///) après file: :
    • 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.
    Exemples :

    Linux file:///opt/IBM/JazzTeamServer/server/conf

    Windows file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf

    Cette propriété système indique où se trouvent certains fichiers de configuration. Sa valeur n'est pas un chemin d'accès standard, mais une URL du style suivant : file:///chemin_fichier.
    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.
    java.awt.headless true  
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin true  
    Oracle

    ORACLE_JDBC_DRIVER_FILE

    Chemin absolu du pilote-JDBC/ojdbc6.jar Le chemin d'accès au pilote JDBC doit être un chemin absolu. N'utilisez pas d'URL (file:///). 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

    SQL_JDBC_DRIVER_FILE

    Chemin absolu du pilote-JDBC/sqljdbc4.jar Le chemin d'accès au pilote JDBC doit être un chemin absolu. N'utilisez pas d'URL (file:///). Pour plus d'informations concernant la connexion à une base de données SQL Server, consultez la documentation relative à la solution Rational pour la gestion collaborative du cycle de vie (en anglais).
    log4j.configuration file:///RépInstallJazz/server/conf/startup_log4j.properties  
  3. 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. Sous Propriétés supplémentaires, cliquez sur Pools d'unités d'exécution > WebContainer. Faites passer la taille maximale par défaut de 50 à 200 unités d'exécution et cliquez sur Sauvegarde dans la configuration principale.

  4. Configurez la propriété personnalisée InvalidateOnUnauthorizedSessionRequestException.
    Cliquez sur Serveurs > Types de serveur > Serveurs d'applications > Serveur1 > Gestion de session > Propriétés personnalisées > Nouveau. Entrez la paire nom-valeur de votre propriété personnalisée. Cliquez sur OK ou Appliquer, puis sur Sauvegarder dans la barre des tâches de la console pour sauvegarder les modifications apportées à la configuration.
    Tableau 3. Propriétés personnalisées
    Nom de la propriété personnalisée Valeur de la propriété personnalisée Commentaires
    InvalidateOnUnauthorizedSessionRequestException true La valeur par défaut pour cette propriété personnalisée de gestion de session est false (faux).
  5. Spécifiez la bibliothèque partagée Jazz Reporting Service.
    1. Dans la console d'administration, accédez à Environnement > Bibliothèques partagées. Remplacez la portée de la liste déroulante par serveur et cliquez sur Nouveau.
    2. Entrez comme nom de bibliothèque partagée JRS Shared Library, ajoutez une description et entrez rép_installation_5.0.1/server/conf/rs/SharedLibrary pour le chemin de classes. Sous Chargement des classes, cochez la case d'utilisation d'un chargeur de classes isolé pour la bibliothèque partagée et cliquez sur Appliquer.
    3. Cliquez sur Sauvegarder dans la configuration principale.
  6. Redémarrez le serveur d'applications pour que les modifications soient prises en compte.
    • Linux Exécutez stopServer.sh puis startServer.sh
    • Windows Exécutez stopServer.bat puis startServer.bat

Que faire ensuite

  1. Déployez les fichiers de vos applications.
    1. Dans la console d'administration WebSphere Application Server, cliquez sur Applications > Nouvelle application > Nouvelle application d'entreprise.
    2. Dans l'assistant Préparation à l'installation de l'application, sous Chemin de la nouvelle application, sélectionnez Système de fichiers local et spécifiez le chemin complet du fichier de votre application. Dans l'assistant Installation d'une nouvelle application, spécifiez la racine de contexte de l'application et suivez toutes les étapes d'installation. Sur la page récapitulative de l'assistant Installation d'une nouvelle application, vérifiez vos choix et cliquez sur Terminer.
      Tableau 4. Fichiers et valeurs des applications
      Application Chemin complet Racine de contexte
      Rational Engineering Lifecycle Manager rép_installation_RELM/server/webapps/relm.war /relm
      Documentation de Rational Engineering Lifecycle Manager rép_installation_RELM/server/webapps/relmhelp.war /relmhelp
      Application de gestion des configurations (Configuration Management) rép_installation_RELM/server/webapps/vvc.war /vvc
      Jazz Reporting Service rép_installation_RELM/server/webapps/rs.war /rs
    3. Cliquez sur Sauvegarde dans la configuration principale.

  2. Ajoutez la référence de la bibliothèque Jazz Reporting Service.
    1. Accédez à Applications > Types d'applications > Applications d'entreprise WebSphere et cliquez sur rs_war dans la liste des applications.
    2. Dans la section Référence, cliquez sur Références de bibliothèque partagée.
    3. Cochez la case en regard de rs_war et cliquez sur Bibliothèques partagées de référence.
    4. Sélectionnez Bibliothèque partagée JRS et cliquez sur la flèche droite.
    5. Cliquez sur OK. Cliquez à nouveau sur OK pour enregistrer vos modifications dans la configuration principale.

  3. Assurez-vous que l'ordre de chargement des classes de Jazz Reporting Service soit correctement configuré.
    1. Accédez à Applications > Types d'applications > Applications d'entreprise WebSphere et cliquez sur rs_war dans la liste des applications.
    2. Dans la section Propriétés détaillées, cliquez sur Chargement des classes et détection des mises à jour.
    3. Dans la section Ordre des chargeurs de classes, sélectionnez Classes chargées avec le chargeur de classes local en premier (parent en dernier).
    4. Cliquez sur OK et sur Sauvegarde dans la configuration principale.

  4. 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 la documentation produit de WebSphere Application Server. Pour plus d'informations, reportez-vous à la documentation produit WebSphere et recherchez l'expression suivante : Sécurisation d'applications et de leur environnement.

Commentaires