<< PREVIOUSNEXT >>

 

MANUAL INSTRUMENTATION

 

This section describes the steps involved when Auto-Instrumentation method is not possible. Follow either Method 1 or Method 2 described below

 

Method 1:

  1. Shut down Wildfly Server (if it is running)

  2. Add the content below to file standalone.conf.bat in the directory %WildFly_HOME%\bin:

     

    @echo off

    ECHO.%JAVA_TOOL_OPTIONS%| FIND /I "instrumentation.jar">Nul || (

    set JAVA_TOOL_OPTIONS=%JAVA_TOOL_OPTIONS% -javaagent:"%VSP_HOME_WEB_MEM%"\iae-java\instrumentation.jar -Dvirsec_appcontextpath=<AppCollectiveID>

    )

     

    NOTE:

    Ensure that <AppCollectiveID> mentioned above is replaced with the App Collective ID in the CMS Application Configuration section

     

  3. Save the modified file standalone.conf.bat

  4. Start the Wildfly Server

Method 2:

 

This method can be used for VSP instrumentation in Domain Mode deployment

  1. Log in to Virtual Machine where WildFly is installed

  2. Stop the Wildfly service if it is running

  3. Modify the file %WildFly_Home%\domain\configuration\host-slave.xml to include the following underlined entries for the server to be instrumented

    In this example, arguments are configured for JVM “server-one”

     

    Before Change:

    image2

    After Change:

    image3

     

    NOTE:

    Ensure that <AppCollectiveID> mentioned above is replaced with the App Collective ID in the CMS Application Configuration section

     

  4. Start the Wildfly service

  5. Application Deployment Folder

    1. Log in to the Virtual Machine where WildFly is installed

    2. Utilize the below path as Application Deployment Folder

      %WildFly_Home%\domain

    3. Example: D:\wildfly-21.0.1.Final\domain

  6. Startup Script File Path

    1. As the VSP-JVM arguments are configured manually, create a dummy file and provide the file path as Start Up Script File Path in the CMS

 

<< PREVIOUSNEXT >>