Glassfish
Please refer to the Proposed Directory Structure for assistance with the steps below.
Basic Configuration
-
Open the
launcher.cfg
file which is located in the top-level directory of the Java Launcher Pack. -
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. -
Delete the
#
symbol at the beginning of each line to enable settings. -
Set
CONTAINER_HOME
to the location of JDK which your existing Application is using (e.g. Oracle Hotspot version 6u23). -
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). -
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
- On Linux:
-
Set
JAVA_HOME
to the location where you install the Java Launcher Pack:- On Windows: Locate the
asenv.bat
(usually located inglassfish/config
folder of Glassfish), add the following line:set JAVA_HOME=<path-to-waratek-software>\launcher
- On Linux: Locate the
asenv.conf
(usually located inglassfish/config
folder of Glassfish), add the following line:JAVA_HOME=/opt/waratek/launcher
- On Windows: Locate the
-
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>
-
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