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