Glassfish

info

Please refer to the Proposed Directory Structure for assistance with the steps below.

Basic Configuration

1. Open the launcher.cfg file which is located in the top-level directory of the Java Launcher Pack.

2. Search for the following lines:

   #CONTAINER_HOME=<absolute-path>
   #JVM_HOME=<absolute-path>
   #WARATEK_HOME=<absolute-path>

   Relative paths are supported in the JLP configuration file. The paths are resolved relative to the location of the launcher.cfg file that they are defined in.

3. Delete the # symbol at the beginning of each line to enable settings.

4. Set CONTAINER_HOME to the location of JDK which your existing Application is using (e.g. Oracle Hotspot version 6u23).

5. Set JVM_HOME to the location of host JDK which is typically the latest version at the time of the Waratek installation (e.g. Oracle Hotspot version 8u191).

6. Set WARATEK_HOME to the location of the Waratek agent:

   • On Linux:

     WARATEK_HOME=/opt/waratek/agent

   • On Windows:

     WARATEK_HOME=<path-to-waratek-software>\agent

7. Set JAVA_HOME to the location where you install the Java Launcher Pack:

   • On Windows: Locate the asenv.bat (usually located in glassfish/config folder of Glassfish), add the following line:

     set JAVA_HOME=<path-to-waratek-software>\launcher

   • On Linux: Locate the asenv.conf (usually located in glassfish/config folder of Glassfish), add the following line:

     JAVA_HOME=/opt/waratek/launcher

8. Set WARATEK_PROPERTIES:

   • It is recommended that this is set via a command-line argument.
   • The property file can use any name. For the example below we will name this waratek.properties, and assume it references the first available configuration directory, i.e. /opt/waratek/conf_1.
   • If using the Waratek Proposed Directory Structure on Linux, add the following line to <path/to/glassfish_home>/domains/<domain name>/config/domain.xml:

     <jvm-options>-Dcom.waratek.WaratekProperties=/opt/waratek/conf_1/waratek.properties</jvm-options>

   • On Windows, this can be set to wherever the Waratek software is installed, for example:

     <jvm-options>-Dcom.waratek.WaratekProperties=<absolute-path-to-waratek-software>\conf_1\waratek.properties</jvm-options>

9. Start the application and verify Waratek has been installed correctly by checking server logs or noting the Waratek logo on the terminal:

                      __      __
   _ _____ ________ _/ /____ / /__ Waratek Application Security Technologies
   | |/|/ / _ `/ __/ _ `/ __/ -_) '_/ Copyright 2018 / All Rights Reserved
   |__,__/\_,_/_/ \_,_/\__/\__/_/\_\ www.waratek.com / @waratek