Installation d'unJava agent de virtualisation dans unJava application

Pour activer leJava™ agent de virtualisation à capturerJava appels de méthode utilisés par unJava application, vous devez charger l'agent dans le dossierJava machine virtuelle (JVM).

Pour charger l'agent dans la JVM de l'application, modifiez les paramètres de démarrage de l'application. L'agent de virtualisation Java comprend les trois fichiers JAR suivants et un fichier XML pour l'enregistrement ( registration.xml ):
  • greenhat.javaagent.jar
  • greenhat.javaagent.ext.jar
  • greenhat.javaagent.linkage.jar
Ces fichiers JAR fournis dans le package JavaAgent avec IBM® DevOps Test Virtualization Control Panel (Test Virtualization Control Panel) doit toujours être dans le même répertoire. Le répertoire doit être celui auquel l'application peut accéder.

Le registration.xml Le fichier du package JavaAgent ne doit pas nécessairement se trouver dans le même répertoire que les fichiers JAR, mais par défaut, il est supposé que tel est le cas. Si vous placez le registration.xml fichier dans un emplacement différent, spécifiez le chemin dans lejavaagent propriété au format suivant: -javaagent:location of greenhat.javaagent.jar file=location of registration.xml file.

Note:
Dans la procédure suivante, on suppose que les fichiers sont présents dans leC:\RITJavaVirtualizationAgent annuaire. Vous devez mettre à jour le chemin en fonction de votre environnement.
  1. Met lejavaagent propriété dans l'environnement d'application de telle manière qu'elle pointe vers l'emplacement dugreenhat.javaagent.jar déposer.

    La procédure de définition de la propriété dépend de l'environnement utilisé. Les sections suivantes décrivent les étapes de définition de la propriété dans quelques environnements couramment utilisés. Si vous utilisez un environnement qui n'est pas répertorié, consultez la documentation appropriée pour savoir comment définir la propriété.

    • Pour une application Java autonome, effectuez l'une des actions suivantes:
      • Ajouter lejavaagent propriété à la ligne de commande utilisée pour lancer l’application. Par exemple,
        java -javaagent:C:\RITJavaVirtualizationAgent\greenhat.javaagent.jar sample.MyClass
      • Avant de démarrer l'application Java, définissez le JAVA_TOOLS_OPTIONS variable d'environnement. Par exemple,
        JAVA_TOOL_OPTIONS="-javaagent:C:\RITJavaVirtualizationAgent\greenhat.javaagent.jar"
        Note:
        Lorsque vous définissez JAVA_TOOL_OPTIONS en tant que variable d'environnement système, cette option est utilisée par tous les programmes Java de votre ordinateur. Cela peut affecter les performances des applications et amener chaque programme Java à enregistrer des agents Java auprès de Test Virtualization Control Panel.
    • Pour WebSphere Application Server, effectuez les actions suivantes:
      1. Dans la console Websphere Integration Solution, cliquez surLes serveurs > Serveur d'applications WebSphere et sélectionnez le serveur à configurer.
      2. Cliquez surGestion des processus Java > Définition du processus > Machine virtuelle Java.
      3. Dans le champ Arguments JVM génériques, ajoutez le code suivant:
        -javaagent:C:\RITJavaVirtualizationAgent\greenhat.javaagent.jar
    • Pour Apache Tomcat, effectuez les actions suivantes:
      1. Accédez à Apache Tomcat installation directory/bin.
      2. En fonction de votre environnement, ouvrez soit lesetenv.bat fichier ou lesetenv.sh fichier dans un éditeur de texte.
      3. Modifier le CATALINA_OPTS variable pour inclure lejavaagent propriété.
        L'exemple suivant montre comment la propriété est définie dans lesetenv.bat déposer:
        SET CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"C:\RITJavaVirtualizationAgent\greenhat.javaagent.jar"
    • Pour le serveur Redhat JBoss, effectuez les actions suivantes:
      1. Aller àRedHat JBoss install directory/bin.
      2. En fonction de votre environnement, ouvrez soit lestandalone.conf.bat fichier ou lestandalone.conf fichier dans un éditeur de texte.
      3. Modifier le JAVA_OPTS variable pour inclure lejavaagent propriété.
        L'exemple suivant montre comment la propriété est définie dans lestandalone.conf.bat déposer: 
        SET JAVA_OPTS=%JAVA_OPTS% -javaagent:"C:\RITJavaVirtualizationAgent\greenhat.javaagent.jar"
  2. Lorsque vous utilisez l'agent de virtualisation Java avec un serveur d'applications tel que IBM WebSphere® Application Server qui dispose d'un gestionnaire de sécurité Java 2, l'agent risque de ne pas s'exécuter. Dans de tels cas, le serveur d'applications peut ne pas démarrer si vous ne configurez pas correctement Security Manager.

    Pour configurer un gestionnaire de sécurité Java 2 pour qu'il fonctionne avec l'agent de virtualisation Java, ajoutez une autorisation au format suivant au fichierserver.policy déposer:

    grant codeBase "file:C:/RITJavaVirtualizationAgent/*" { permission java.security.AllPermission; };
    Note:
    Si vous utilisez WebSphere Application Server, leserver.policy le fichier se trouve dans ${was.install.root}/profiles/${appserver.name}/properties.
  3. Redémarrez l'application ou le serveur pour que les modifications prennent effet.

L'environnement d'application est configuré pour utiliser l'agent de virtualisation Java. Avant de pouvoir capturer quoi que ce soitJava appels de méthode dans la perspective Recording Studio, vous devez créer unJava méthode de transport dans IBM DevOps Test Integrations and APIs (Test Integrations and APIs). Pour plus d'informations sur la création d'unJava méthode de transport, voir Créer de la logiqueJava ressources d'application.