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