Skip to main content

Red Hat JBoss and WildFly

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 standalone.conf.bat (usually in the bin/ folder of JBoss or WildFly), add the following line:
      set JAVA_HOME=<absolute-path-to-waratek-software>\launcher
    • On Linux: Locate the standalone.conf (usually in the bin/ folder of JBoss or WildFly), add the following line:
      JAVA_HOME=/opt/waratek/launcher
    • On Windows (JBoss 4.x or 5.x): Open run.conf.bat (usually in the bin/ folder), add:
      set JAVA_HOME=<absolute-path-to-java-launcher-pack>
    • On Linux (JBoss 4.x or 5.x): Open run.conf (usually in the bin/ folder), add:
      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.
    • If using the Waratek Proposed Directory Structure on Linux, add the following line to standalone.conf or run.conf:
      JAVA_OPTS="$JAVA_OPTS -Dcom.waratek.WaratekProperties=/opt/waratek/conf_*/<name of property file>"
    • On Windows, this can be set inside standalone.conf.bat or run.conf.bat, for example:
      set JAVA_OPTS=%JAVA_OPTS% -Dcom.waratek.WaratekProperties=<absolute-path-to-waratek-software>\conf_*\<name of property file>
  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