Configuration des variables d'environnement dans le but de profiler un serveur

Le profilage d'un serveur permet d'analyser les performances, les unités d'exécution et l'utilisation de la mémoire lors de l'exécution d'une application Web. Dans certains cas, vous devez configurer des variables d'environnement sur l'ordinateur de l'hôte cible avant de démarrer le serveur en mode profil. Les variables d'environnement doivent être configurées avant de démarrer le serveur à des fins de profilage. Sur les ordinateurs qui exécutent z/OS, vous devez également définir des droits d'accès sur les répertoires utilisés par Rational Agent Controller.

Déterminer s'il est nécessaire de configurer manuellement des variables d'environnement à des fins de profilage

Dans certains cas, il n'est pas nécessaire de définir manuellement les variables d'environnement sur l'ordinateur cible lors du profilage. Celles-ci sont définies automatiquement par le plan de travail. Dans d'autres cas, les variables d'environnement doivent être définies manuellement. Les facteurs suivants déterminent les circonstances dans lesquelles cela est nécessaire et indiquent les variables d'environnement à définir :
  • Si l'ordinateur cible du serveur est le même que celui sur lequel le plan de travail est installé (serveur local) ou si le serveur est installé sur un ordinateur différent (ordinateur distant).
  • Si l'ID utilisateur a des droits d'accès en écriture sur le répertoire /java/jre/bin/ pour WebSphere Application Server (serveur local).
  • La version de Rational Agent Controller installée (serveur distant).
Le tableau suivant décrit les conditions dans lesquelles les variables d'environnement sont définies automatiquement ou doivent être définies manuellement.
Tableau 1. Scénarios de définition automatique ou manuelle des variables d'environnement lors du profilage. Les variables d'environnement sont définies pour les serveurs locaux et distants.
Variable d'environnement Serveur local Serveur distant
  • Pour Windows
    PATH
  • Pour Linux
    Pour Solaris
    LD_LIBRARY_PATH
  • Pour AIX
    Pour z/OS
    LIBPATH
Définie automatiquement par le plan de travail. Définie automatiquement si le serveur distant utilise Rational Agent Controller V8.3 ou version ultérieure. Sinon, elles sont définies manuellement.
Remarque :
Pour z/OS
Assurez-vous que la variable d'environnement LIBPATH inclut le chemin <répertoire d'installation de XML Toolkit>/xml4c-5_7/lib.

Par exemple, si vous avez installé XML Toolkit dans /usr/lpp/ixm/IBM/xml4c-5_7, la variable d'environnement doit contenir le chemin : LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib.

Remarque :
For z/OS
Vous devez également avoir des droits d'accès en lecture et en exécution sur le <répertoire d'installation de XML Toolkit>/xml4c-5_7/lib et d'autres répertoires. Voir Définition des droits d'accès aux fichiers pour le profilage sous z/OS.
TPTP_AC_HOME Définie automatiquement par le plan de travail. Définie automatiquement si le serveur distant utilise Rational Agent Controller V8.3 ou version ultérieure. Sinon, elle est définie manuellement.
PROBEKIT_HOME (nécessaire uniquement si vous utilisez l'option de surveillance Insertion de sonde.) Définie automatiquement par le plan de travail. Définie manuellement.
JAVA_PROFILER_HOME Définie automatiquement par le plan de travail. Définie automatiquement si le serveur distant est installé sous Windows or Linux par le biais de Rational Agent Controller 8.3 ou version ultérieure. Sinon, elle est définie manuellement.

Configuration manuelle du profilage des variables d'environnement d'un serveur local

Pour un serveur exécute sur la même machine que le plan de travail, procédez comme suit :
  1. Localisez les dossiers de plug-in suivants dans le répertoire d'installation d'IBM® Rational Software Delivery Platform
    Remarque : Lorsqu'il existe plusieurs versions d'un plug-in, sélectionnez toujours celle ayant le numéro de version et l'horodatage le plus récent.
    Tableau 2. Chemins d'accès aux plug-ins utilisés pour définir les variables d'environnement à des fins de profilage sur un serveur local. Utilisez le chemin d'accès du plug-n pour déterminer la variable d'environnement.
    Description Chemin du plug-in
    <Agent Controller Home>
    • Pour Windows
      <rép_install>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller
    • Pour Linux
      <rép_install>/IBMIMShared/plugins/org.eclipse.tptp.platform.ac.linux_<XXXX>/agent_controller
    où <rép_install> correspond au répertoire d'installation d'IBM Rational Software Delivery Platform et <XXXX> dépend de l'architecte du système d'exploitation. Remplacez <XXXX> par le processeur approprié en sélectionnant ia32 pour un processus 32 bits, em64 pour un processeur 64 bits ou ipf pour un processeur Itanium, par exemple org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>, où <n.n.n> correspond à un numéro de version et <yyyymmddtttt> à une date et à un horodatage du plug-in.
    <Probekit Home>
    • Pour Windows
      <rép_install>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>\os\win32\x86
    • Pour Linux
      <rép_install>/IBMIMShared/plugins/org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>/os/linux/x86
    où <rép_install> correspond au répertoire d'installation d'IBM Rational Software Delivery Platform et <XXXX> dépend de l'architecte du système d'exploitation. Remplacez <XXXX> par le processeur approprié en sélectionnant ia32 pour un processus 32 bits, em64 pour un processeur 64 bits ou ipf pour un processeur Itanium, par exemple org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>, où <n.n.n> correspond à un numéro de version et <yyyymmddtttt> à une date et à un horodatage du plug-in.
  2. Configurez les variables d'environnement suivantes avant de démarrer le plan de travail et le serveur d'applications. Ouvrez une invite de commande et entrez les commandes suivantes en remplaçant les chemins d'accès <Agent Controller Home> et <Probekit Home> par ceux du plug-in déterminés à l'étape précédente :
    Pour Windows
    set TPTP_AC_HOME=<Agent Controller Home> set PROBEKIT_HOME=<Probekit Home> set PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%PATH%
    Pour Linux
    export TPTP_AC_HOME=<Agent Controller Home> export PROBEKIT_HOME=<Probekit Home> export LD_LIBRARY_PATH=$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME:$LD_LIBRARY_PATH

Configuration manuelle des variables d'environnement à des fins de profilage sur un serveur distant

Pour les serveurs d'applications exécutés sur un ordinateur différent de celui du plan de travail, procédez comme suit :
Remarque : Si vous profilez un serveur d'applications distant, vous devez installer Rational Agent Controller sur la même machine que celle où est installé le serveur d'applications. Vérifiez que les paramètres de la variable d'environnement répertoriés ci-dessous sont sélectionnés par le processus de démarrage du serveur d'applications.
Sur l'ordinateur où se trouve le serveur d'applications distant, configurez les variables d'environnement avant de démarrer le plan de travail et le serveur d'applications. Vous pouvez configurer manuellement les variables d'environnement suivantes sur le système cible en remplaçant <répertoire d'installation d'AC> par le répertoire d'installation de Rational Agent Controller. De plus, si vous utilisez l'option de surveillance Insertion de sonde, spécifiez la variable d'environnement PROBEKIT_HOME :
Pour Windows
set TPTP_AC_HOME=<répertoire d'installation d'AC> set JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler set PROBEKIT_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.hyades.probekit set PATH=%JAVA_PROFILER_HOME%;%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%\lib;%PATH%
Pour Linux
Pour Solaris
export TPTP_AC_HOME=<répertoire d'installation d'AC> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LD_LIBRARY_PATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LD_LIBRARY_PATH
Pour AIX
export TPTP_AC_HOME=<répertoire d'installation d'AC> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
Pour z/OS
export TPTP_AC_HOME=<répertoire d'installation d'AC/RACzOS64 or 31bit> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export XERCESC_HOME=<répertoire d'installation de XML Toolkit>/xml4c-5_7/lib export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH

<répertoire d'installation de XML Toolkit> correspond généralement à /usr/lpp/ixm/IBM.

Remarque : Si vous avez activé la sécurité lors de l'installation de Rational Agent Controller, entrez les commandes suivantes :
  • extattr +ap <répertoire de Rational Agent Controller>/lib/*
  • extattr +ap <répertoire Rational Agent Controller>/plugins/org.eclipse.tptp.javaprofiler/*
  • extattr +ap <répertoire d'installation de XML Toolkit>/xml4c-5_7/lib/*

Démarrage du plan de travail

Après avoir configuré les variables d'environnement requises, démarrez le plan de travail IBM Rational Software Delivery Platform à partir d'une invite de commande de manière à ce que les variables d'environnement soient sélectionnées par le processus du plan de travail. Par exemple, exécutez la commande suivante :
Pour Windows
C:\Program Files\IBM\SDP>eclipse
Pour Linux
/opt/IBM/SDP>./eclipse
Remarque : Lors du profilage avec WebSphere Application Server, la configuration des variables d'environnement peut être ajoutée au fichier setupCmdLine.bat (Windows) ou setupCmdLine.sh (Linux) qui se trouve dans le dossier /bin de l'installation du serveur.

Définition des droits d'accès aux fichiers pour le profilage sous z/OS

Pour z/OS
Si vous effectuez le profilage sous z/OS, vous devez disposer de droits d'accès en lecture et en exécution sur les répertoires suivants (et tous les répertoires et leurs chemins) :
  • <répertoire d'installation de Rational Agent Controller>/lib/*
  • <répertoire d'installation de Rational Agent Controller>/plugins/org.eclipse.tptp.javaprofiler/*
  • <répertoire d'installation de XML Toolkit>/xml4c-5_7/lib*
Remarque : Tous les répertoires figurant dans le chemin d'accès à ces répertoires doivent également disposer de droits de lecture et d'exécution. Par exemple, si <répertoire d'installation de Rational Agent Controller> correspond à /opt/IBM/RAC, vous devez disposer de droits de lecture et d'exécution sur chacun des répertoires /opt, /opt/IBM, /opt/IBM/RAC et /opt/IBM/RAC/lib/.
Pour affecter les droits d'accès corrects sur ces répertoires, exécutez la commande umask 022 :
  1. Dans un interpréteur de commandes UNIX System Services, accédez au répertoire <répertoire d'installation de Rational Agent Controller>/RACzOS31bit/bin.
  2. Exécutez les commandes suivantes : umask 022
  3. Démarrez le contrôleur d'agent : ./ACStart.sh.
Icône indiquant le type de rubrique Rubrique de référence
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : rprofilingenvvar.html