Skip to content

Configure Lightrun with Oracle WebLogic Server

WebLogic is a Java application server by Oracle. The Enterprise Application (EAR) file contains the WebLogic Server configurations that need to be updated for Lightrun integration.

To use Lightrun with a WebLogic server, add the Lightrun Java agent path as an additional JAVA_OPTS parameter to the WebLogic startWebLogic.sh script.

Configure Lightrun with Oracle WebLogic (version 1.14.1.2 and higher)

As part of the process, update the WebLogic startup script.

  1. Copy the Lightrun Java agent path according to your configuration.

    -agentpath:<install_dir>/agent/lightrun_agent.so=--lightrun_extra_class_path=<weblogic-deploy-path>/<app-name.ear>
    
    Example: '--lightrun_extra_class_path=Oracle/Middleware/user_projects/domains/mydomain/deployments/myapp.ear'
    
  2. Modify the startWebLogic.sh script file.

    Add the Lightrun Java agent path as an additional parameter to JAVA_OPTS incluing the -DUseSunHttpHandler support HTTPS communication.

    /Oracle/Middleware/Oracle_Home/user_projects/domains/base_domain/bin

    As displayed in the following example:

    export JAVA_OPTIONS="-agentpath:/tmp/agent/lightrun_agent.so=--lightrun_extra_class_path=<full path to file>/app.war,--alsologtostderr=1 -DUseSunHttpHandler=true"`
    
    For more information, see Updating WebLogic domain settings in the setDomainEnv script file.

Configure Lightrun with Oracle WebLogic (version 1.14.1.1 and lower)

  1. Add the Lightrun Java agent path using one of the following methods:

    • Perform directly in the WebLogic Admin console:

      1. Copy the Lightrun Java agent path from the Lightrun Management Portal.

        -agentpath:<install_dir>/agent/lightrun_agent.so=--lightrun_extra_class_path=<weblogic-domain-path>/applications/<app-name>/WEB-INF/classes/
        
      2. Navigate to the Admin panel (e.g., http://localhost:7001/console)

      3. Press Lock & Edit.
      4. Navigate to (environment) > Servers > (server).
      5. Navigate to the Start/Stop tab.
      6. Update the Arguments with the Lightrun Java agent path.
    • Update the WebLogic startup script:

      1. Copy Lightrun Java agent path and update it according to your configuration.

      -agentpath:<install_dir>/agent/lightrun_agent.so=--lightrun_extra_class_path=<weblogic-deploy-path>/<app-name.ear>
      
      2. Modify the setDomainEnv script file.

      3. Add the Lightrun Java agent path as an additional parameter to JAVA_OPTS:

      Oracle/Middleware/user_projects/domains/<your-domain>/bin/setDomainEnv.sh
      
      For more information, see Updating WebLogic domain settings in the setDomainEnv script file

  2. To enable SSL communication, add the following JVM flag to your application's startup parameters or WebLogic's JVM options.

    -DUseSunHttpHandler=true
    

Last update: February 20, 2025