<< PREVIOUSNEXT >>

 

 

MANUAL INSTRUMENTATION

 

Supported Windows Version: The following configuration is tested on Windows 2016 Operating System. To manually configure the TomcatServer with VSP, follow the steps below: 

 

Method 1: Script based startup:

  1. Shut down Tomcat Server (if it is running) using the command:

    1. %CATALINA_HOME%\bin\shutdown.bat

       

       

  2. Create a file setEnv.bat in the directory %CATALINA_HOME%\bin. Add content below to the file:

     

    @echo off

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

    set JAVA_TOOL_OPTIONS=%JAVA_TOOL_OPTIONS% -javaagent:"%VSP_HOME%"\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 setEnv.bat

  4. Start the Tomcat Server using the command:

    1. %CATALINA_HOME%\bin\startup.bat

       

       

Method 2: Tomcat Services based Startup:

  1. If the Tomcat Server is running, shut down the server using Windows Services

    Example Service Name: Apache_Tomcat-7

  2. Navigate to the directory: %CATALINA_HOME%\bin

    Example: D:\tomcat-7.0.85\bin

  3. Open command prompt

  4. Right-click on properties and procure the value of Service Name

    Example: Apache_Tomcat-7

    image1

  5. Edit the parameters of the service:

    1. In the Java tab, modify the parameters, Java Options to add the Service Name (obtained in Step 4)

      image2

    2. Add VSP JVM argument to Java Options as described below

      1. Before Modification:

        image3

      2. After Modification:

        -Dcatalina.home=D:\tomcat-7.0.85

        -Dcatalina.base=D:\tomcat-7.0.85

        -Dignore.endorsed.dirs=D:\tomcat-7.0.85\endorsed

        -Djava.io.tmpdir=D:\tomcat-7.0.85\temp

        -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager

        -Djava.util.logging.config.file=D:\tomcat-7.0.85\conf\logging.properties

        -javaagent:c:\PROGRA~2\Virsec\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

         

  6. Start the Tomcat Server using Windows Services

    Example Service Name: Apache_Tomcat-7

 

<< PREVIOUSNEXT >>