Utilisation d'un élément Probekit en mode autonome sur AIX

Icône de plateforme AIX Cette section décrit en détail comment utiliser un élément Probekit en mode autonome sur les systèmes AIX.

Pour utiliser un élément Probekit en mode autonome, Agent Controller doit être installé sur le système cible. L'agent de collecte des données et la bibliothèque d'extension de Probekit sont installés automatiquement avec Agent Controller.

Pour exécuter l'application en utilisant l'élément Probekit en mode autonome, procédez comme suit :

  1. Importez ou créez une sonde dans le plan de travail.
  2. Dans la définition de la sonde, incluez les spécifications de cibles spéciales décrites dans Définition des cibles dans les sondes d'un élément Probekit autonome.
  3. Copiez tous les fichiers sonde vers un dossier de la machine cible. Si vous utilisez plusieurs sondes, vous devez concaténer le contenu des fichiers probescript dans un seul fichier probescript.
  4. Ajoutez le dossier contenant les fichiers sonde au chemin d'accès aux classes de la machine cible.
  5. Ajoutez le dossier de bibliothèque RAC et le dossier du plug-in Probekit à la variable d'environnement LIBPATH de la machine cible :
    <racInstallDir>/lib
    <racInstallDir>/plugins/org.eclipse.hyades.probekit/lib
  6. Ajoutez la chaîne d'option suivante à la ligne de commande qui lance votre programme :
    -XrunpiAgent:server=standalone,
    mode=none,
    extensionLibrary=ProbeAgentExtension.so,
    ext-pk-BCILibraryName=BCIEngProbe.so,
    ext-pk-probescript=<chemin_absolu_du_fichier_probescript>
    <chemin_absolu_du_fichier_probescript> est le chemin absolu du fichier .probescript de votre sonde. (Par exemple : <chemin_absolu_du_fichier_probescript> = /home/Project/Probes/myprobe.probescript). Notez qu'il doit s'agir du fichier .probescript et non pas du fichier .probe.
    Remarque : La chaîne d'option ci-dessus est présentée sur plusieurs lignes pour faciliter sa lecture. Lorsque vous incluez la chaîne d'option dans la ligne de commande, elle doit se trouver sur une seule ligne et ne comporter aucun espace.
    Pour que l'agent Probekit écrive des messages de consignation, ajoutez les options suivantes à la ligne de commande :
    Option Description
    ext-pk-logFile=<fichier> Définit le nom du fichier dans lequel l'agent Probekit doit écrire les messages de consignation. <fichier> peut être un chemin complet et un nom de fichier. Si vous indiquez standard error à la place d'un nom de fichier, la sortie de consignation est écrite dans le canal standard des erreurs. Si vous ne définissez pas cette option, aucune sortie de consignation n'est écrite.
    ext-pk-logLevel=<niveau> Définit le niveau de consignation à utiliser. Voir le tableau ci-dessous pour les niveaux de consignation et leur descriptions.
    Vous pouvez définir les niveaux de consignation suivants :
    Niveau Description
    Aucun Ne produit aucune sortie de consignation.
    Grave Consigne uniquement les erreurs graves, telles que l'impossibilité de lire les bibliothèques.
    Avertissement Consigne les messages d'avertissement. Il s'agit du niveau par défaut.
    Info Consigne les messages d'état, tels que "Initialisation en cours".
    Config Consigne les événements et les informations de configuration, tels que le contenu du fichier .probescript.
    Le plus précis Niveau de consignation le plus précis. Le fichier journal contient le nom de chaque classe instrumentée par l'agent Probekit.