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