Configuration de WebSphere Application Server

Avant de pouvoir déployer les fichiers WAR des applications CLM, vous devez configurer votre serveur 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.

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. Vérifiez ou mettez à jour le niveau WebSphere Application Server. Pour une liste des versions et des groupes de correctifs pris en charge, voir la page Configuration système requise détaillée.
  2. Jazz Team Server requiert des paramètres spécifiques sur la machine virtuelle Java dans laquelle ils sont exécutés. Pour définir ces propriétés, dans la console WebSphere Integrated Solutions, cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > Serveur1.
  3. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition des processus.
  4. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
  5. Ajoutez la valeur 4096 à la zone Taille de pile initiale.
  6. Ajoutez la valeur 4096 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 une mémoire instantanée de 4 Go au processus Jazz Team Server sur un ordinateur 64 bits. Il est important d'utiliser la même quantité pour la taille de pile initiale et pour la taille de pile maximale.

    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 altère les performances du système de gestion de 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 machine 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.

  7. Dans la zone Arguments JVM génériques, entrez la ligne suivante :
    For AIX operating system
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xnocompressedrefs
    For Solaris operating system
    -Xmx4g -Xms4g -Xmn512m
    -XX:MaxPermSize=768M -XX:ReservedCodeCacheSize=512M -XX:CodeCacheMinimumFreeSpace=2M
    Remarque : Mac OS X n'est pas pris en charge.
    -Xmx4g -Xms4g -Xmn512m
    -XX:MaxPermSize=768M -XX:ReservedCodeCacheSize=512M -XX:CodeCacheMinimumFreeSpace=2M
    For Windows operating system
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    For Linux operating system
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Conseil : Si vous avez besoin d'une taille de segment de mémoire plus importante, remplacez {N} par la quantité de mémoire à utiliser et {N/8} par le 1/8 de la mémoire totale. Par exemple, si -Xmx est défini sur 8g, -Xmn doit être défini sur 1g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  8. Cliquez sur Appliquer, puis sur Sauvegarde dans la configuration principale.
  9. 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épartie dans lequel vous utilisez un serveur d'applications distinct pour chaque application Web, vous devez ajouter ces propriétés personnalisées pour chaque instance de WebSphere Application Server.
  10. Cliquez sur Nouvelle, entrez JAZZ_HOME dans la zone Nom et file:///Rép_install_Jazz/server/conf dans la zone Valeur. Remplacez RépInstallJazz 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:///home/utilisateur/IBM/JazzTeamServer/server/conf sur les systèmes UNIX.
    Remarque : Pour éviter tout problème, n'utilisez pas d'espaces dans les chemins de fichier. Pour le répertoire Program Files, vous pouvez utiliser PROGRA~1, et pour le répertoire Program Files (x86), vous pouvez utiliser PROGRA~2.
  11. Cliquez sur OK.
  12. 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 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 JDBC (Java Database Connectivity) Oracle, reportez-vous à la rubrique suivante Configuration d'une base de données Oracle.
    • Si vous vous connectez à une base de données SQL Server, Nom : SQLSERVER_JDBC_DRIVER_FILE Valeur : Chemin absolu au pilote JDBC /sqljdbc4.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 JDBC SQL Server, voir Configuration d'une base de données de serveur SQL.
    • 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.
  13. Cliquez sur Sauvegarde dans la configuration principale.
  14. Pour que les modifications soient prises en compte, redémarrez le serveur d'applications.

Commentaires