Réglage des paramètres WebSphere Application Server dans le but d'optimiser les performances du serveur ClearQuest Web

Examinez les paramètres WebSphere Application Server pour le profil de serveur d'applications de ClearQuest Web Server. Si vous avez installé ClearQuest dans un nouveau profil, les paramètres dans le profil créé au moment de l'installation sont optimisés afin d'améliorer les performances. Si vous avez effectué l'installation sur un profil existant ou que le serveur rencontre des problèmes de performance, il est possible que les valeurs de paramètre nécessitent un ajustement.

Avant de commencer

Pour obtenir des informations sur la définition des paramètres pour les profils de serveur d'applications WebSphere Application Server, consultez ces ressources.
  • Consultez le centre de documentation Réglage des performances WebSphere Application Server, V8.0, V8.5.
  • Sur IBM® DeveloperWorks, recherchez Réglage de WebSphere Application pour trouver des articles sur le réglage des paramètres de profil WebSphere Application Server afin d'améliorer les performances.

Lorsque vous effectuez la mise à niveau des composants Web Rational vers la version 8.0.1, vous pouvez déployer les composants sur WebSphere Application Server V8.5.x. Avant de déployer les composants Web Rational mis à niveau, mettez également à niveau la version existante de WebSphere Application Server vers la nouvelle version ou une autre instance V8.5.x.

Les composants Web ClearCase et ClearQuest V8.0.1 prennent en charge le déploiement dans WebSphere Application Server version 8.0.0.x et 8.5.x. Selon la version du produit Rational installée et la version de WebSphere Application Server utilisée pour le déploiement, la mise à niveau vers le serveur de réseau étendu CCRC ClearCase ou le serveur Web ClearQuest V8.0.1 peut nécessiter l'installation d'une nouvelle instance de WebSphere Application Server et d'IBM HTTP Server ou la mise à niveau de la version existante.

Pour installer ou mettre à niveau WebSphere Application Server V8.5.x en vue de prendre en charge le serveur de réseau étendu CCRC ClearCase et le serveur Web ClearQuest V8.0.1 :
  • Installez une nouvelle instance de WebSphere Application Server 8.5.x dans l'un des cas suivants :
    • Lorsque vous effectuez une mise à niveau à partir de ClearCase ou ClearQuest V7.1.1.x, V7.1.2.x vers V8.0.1
    • Lorsque vous effectuez une mise à niveau à partir d'une installation ClearCase ou ClearQuest V8.0 ou V8.0.0.1 déployée vers WebSphere Application Server V7.0.x
  • Si vous effectuez une mise à niveau vers ClearCase ou ClearQuest V8.0.1 à partir d'une installation V8.0.0.x déployée vers WebSphere Application Server V8.0.0.x, vous pouvez mettre à niveau la version existante de WebSphere Application Server vers la version 8.5.x ou continuer à utiliser WebSphere Application Server V8.0.0.x.
Remarque : Cet article du support IBM comporte plus d'informations détaillées sur les tâches d'installation et de mise à niveau suivantes :
  • Matrice des scénarios d'installation, de mise à niveau et d'annulation pris en charge
  • Informations sur la mise à niveau d'une installation existante des composants de WebSphere Application Server et d'IBM HTTP Server
  • Instructions sur la mise à niveau des composants Web ClearCase et ClearQuest et sur leur déploiement ou redéploiement vers WebSphere Application Server

Pourquoi et quand exécuter cette tâche

Tableau 1 répertorie les paramètres recommandés pour le profil WebSphere Application Server où le serveur Rational ClearQuest Web est déployé. Ces valeurs sont appliquées par défaut lorsque ClearQuest Web Server est déployé dans un nouveau profil créé au moment du processus d'installation ou de mise à niveau de ClearQuest.

Pour obtenir des performances optimales, assurez-vous que les paramètres Taille de segment de mémoire JVM et Pools d'unités d'exécution sont définis sur leur valeurs recommandées pour le profil de serveur Web ClearQuest.
Tableau 1. Paramètres WebSphere Application Server par défaut recommandés pour le serveur Web ClearQuest
Paramètre WAS Nom de paramètre Valeur optimisée Description
Taille de segment de mémoire JVM setJvmMaxHeapSize 1536 Mo Contrôle la consommation de mémoire de la machine virtuelle Java™. La définition d'une valeur trop faible peut entraîner des erreurs fréquentes liées à une insuffisance de mémoire.
Pools d'unités d'exécution setMaxSizesOfThreadPools 200 Indique le nombre maximal d'unités d'exécution à gérer dans le pool d'unités d'exécution par défaut. La modification de cette valeur peut avoir un impact sur les temps de démarrage et de traitement.
Infrastructure PMI disablePMI ou enablePMI disablePMI Désactive le processus de collecte des données PMI qui collecte des informations pour le diagnostique des problèmes et l'optimisation des performances de l'application. La désactivation de la collecte de données améliore les performances du serveur. Vous pouvez activer l'infrastructure PMI à des fins d'identification et de résolution des problèmes lorsque cela est nécessaire.
Taille du fichier journal de la machine virtuelle Java setSystemOutErr 20 Mo Définit la taille des fichiers SystemOut.log et SystemErr.log de la machine virtuelle Java. L'emplacement par défaut pour ces journaux est
Windows
C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\cqwebprofile\logs\server1
Linux et UNIX
/opt/IBM/RationalSDLC/ClearQuest/cqweb/cqwebprofile
Journal de trace setTraceLog 20 Mo  
Paramètre de délai d'attente d'écriture pour le canal entrant HTTP setDefaultInboundHttpChannelWriteTimeouts 300 secondes Indiqué la durée, en secondes, pendant laquelle le canal de transport HTTP attend sur un socket pour chaque portion de données de réponse à transmettre. La définition d'une valeur trop faible peut entraîner des interruptions de connexions et des échecs de téléchargement. Dans ce cas, les fichiers journaux du serveur risquent de présenter des erreurs de type IOError ou AsyncTimeoutException.
Remarque :
Si vous sélectionnez Installation Manager pour déployer ClearQuest Web Server dans un nouveau profil WebSphere, appelé 'cqwebprofile', Installation Manager prédéfinit ces valeurs par défaut sur le paramètre optimal. Si vous choisissez de déployer ClearQuest Web dans un profil WebSphere existant, ces paramètres optimaux ne peuvent pas être définis. Vous devez les définir.

Modification des paramètres de profil de serveur d'applications WebSphere à l'aide de l'outil wsadmin

Modification des paramètres du profil WebSphere Application Server du profil ClearQuest Web Server à l'aide de l'outil teamAdminUtils.jacl.

Pourquoi et quand exécuter cette tâche

Vous pouvez utiliser l'outil teamAdminUtils.jacl pour définir les paramètres recommandés par défaut pour un profil ClearQuest Web. Vous pouvez également exécuter cette commande en vue de changer des valeurs spécifiques. Par exemple, pour définir les valeurs par défaut, utilisez setCMRecommendedDefaults. Pour changer uniquement la taille de segment de mémoire JVM, utilisez setJvmMaxHeapSize.

Pour plus d'informations sur l'outil wsadmin, voir le centre de documentation de WebSphere Application Server : V8.5, V8.0

Procédure

Définissez les paramètres de WebSphere Application Server pour le profil d'application du serveur Web ClearQuest sur les valeurs recommandées

  1. Démarrez la console d'administration de WebSphere Application Server, ouvrez la fenêtre de commande ou l'interpréteur de commandes et accédez au répertoire bin de WebSphere Application Server.
    • Windows :
      cd C:\Program Files\IBM\WebSphere\bin\
    • UNIX ou Linux :
      cd /opt/IBM/WebSphere/bin/
  2. Exécutez la commande setCMRecommendedDefaults pour appliquer les valeurs par défaut au profil hébergeant ClearQuest Web Server.
    • Windows :
      wsadmin.bat -profile -profileName cqwebprofile "C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\scripts\teamAdminUtils.jacl" -c "setCMRecommendedDefaults"
    • UNIX ou Linux :
      ./wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setCMRecommendedDefaults"
  3. Redémarrez le profil de WebSphere Application Server pour que le changement soit appliqué.
    • Windows :
      stopServer.bat server1 -profileName cqwebprofile
      startServer.bat server1 -profileName cqwebprofile
    • UNIX ou Linux :
      ./stopServer.sh server1 -profileName cqwebprofile
      ./startServer.sh server1 -profileName cqwebprofile
    Remarque : Si vous possédez l'édition 32 bits de WebSphere Application Server, vous pouvez disposer d'une taille de segment de mémoire JVM maximum 1 536 Mo. Si vous dépassez cette valeur, vous ne pouvez pas démarrer votre profil ClearQuest Web. Pour l'édition 64 bits, vous pouvez augmenter cette valeur sur plus de 2 Go, ce qui peut entraîner de mauvaises performances en raison du dépassement du contexte graphique Java.
    Remarque : Les exemples présentés dans cette procédure supposent que le serveur Web ClearQuest est déployé dans le profil par défaut cqwebprofile. Si vous déployez le serveur Web ClearQuest avec un autre nom de profil, utilisez ce nom de profil au lieu de cqwebprofile. Cet exemple suppose que WebSphere et ClearQuest sont installés dans le répertoire par défaut.
  4. Lors de l'installation ou de la mise à niveau vers le serveur Rational ClearQuest Web V8.0 ou V8.0.0.x, IBM Installation Manager ne définit pas la valeur de la taille de segment de mémoire JVM pour le profil WebSphere Application Server. Par défaut, lors de la création d'un nouveau profil WebSphere Application Server, la valeur JVM est définie sur 256 Mo. Cette valeur est trop faible pour le serveur Web ClearQuest V8.0 et V8.0.0.x et doit passer à 1 Go. Pour augmenter la valeur :
    1. Dans une fenêtre d'invite de commande Windows ou un interpréteur de commandes UNIX ou Linux, accédez à votre répertoire de scripts ClearQuest. Par exemple, sous :
      • Windows :
        cd C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\scripts\
      • UNIX ou Linux :
        /opt/ibm/RationalSDLC/clearquest/cqweb/scripts/
    2. Exécutez la commande WebSphere suivante pour définir la taille de segment de mémoire JVM pour le profil WebSphere Application Server dans lequel le serveur Web ClearQuest est déployé sur 1024. Par exemple :
      • Windows :
        C:\Program Files\IBM\WebSphere\AppServer\bin\wsadmin.bat -profile -profileName cqwebprofile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"
      • UNIX ou Linux :
        /opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setJvmMaxHeapSize 1024"
    3. Redémarrez le profil WebSphere Application Server pour que le changement prenne effet. Par exemple :
      • Windows :
        C:\Program Files\IBM\WebSphere\AppServer\bin\stopServer.bat server1 -profileName cqwebprofile
        C:\Program Files\IBM\WebSphere\AppServer\bin\startServer.bat server1 -profileName cqwebprofile
      • UNIX ou Linux :
        /opt/IBM/WebSphere/AppServer/bin/stopServer.sh server1 -profileName cqwebprofile
        /opt/IBM/WebSphere/AppServer/bin/startServer.sh server1 -profileName cqwebprofile

Feedback