Skip to main content

Oracle WebLogic

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=<absolute-path-to-waratek-software>\agent
  7. Set JAVA_HOME to the location where you install the Java Launcher Pack:

    • Go to Oracle/Middleware/user_projects/domains/<domain_name>/bin
    • On Windows: Set JAVA_HOME to the launcher directory at the beginning of the setDomainEnv.bat script:
      set JAVA_HOME=<absolute-path-to-waratek-software>\launcher
    • On Linux: Locate the setDomainEnv.sh (usually in Oracle/Middleware/user_projects/domains/<domain_name>/bin), add the following line:
      JAVA_HOME=/opt/waratek/launcher
  8. Set WARATEK_PROPERTIES and -Dweblogic.MuxerClass flag in JAVA_OPTIONS:

    • It is recommended that this is set via 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.
    • Open the setDomainEnv.sh (Linux) or setDomainEnv.bat (Windows) file. If using the Waratek Proposed Directory Structure, add the following to the beginning:
      • On Linux:
        JAVA_OPTIONS="-Dcom.waratek.WaratekProperties=/opt/waratek/conf_1/waratek.properties -Dweblogic.MuxerClass=weblogic.socket.NIOSocketMuxer $JAVA_OPTIONS"
      • On Windows:
        set JAVA_OPTIONS=-Dcom.waratek.WaratekProperties=<absolute-path-to-waratek-software>\conf_1\waratek.properties -Dweblogic.MuxerClass=weblogic.socket.NIOSocketMuxer %JAVA_OPTIONS%
    • Note: For more information on -Dweblogic.MuxerClass, see Tuning Muxers in the Oracle documentation.
  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