Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
weblogic-helloworld
README.md

README.md

Quickstart for debugging Java + Oracle WebLogic

A sample application for debugging Java + Oracle WebLogic using Rookout.

Before following this guide we recommend reading the basic Java + Rookout guide.

Running the app

  1. Download the Rookout Java Agent
  2. Add the Rookout Java Agent and set your organization token in the startWebLogic.sh script
        JAVA_OPTIONS="${SAVE_JAVA_OPTIONS} -javaagent=<ROOK_LOCATION>/rook.jar"
        export ROOKOUT_TOKEN="<Your-Rookout-Token>"
  3. Start your WebLogic server
  4. Build and deploy the WebLogic webservice: You can change the weblogic configuration in the weblogic-helloworld/build.xml
    default url is localhost:7001
    default username/password is weblogic:weblogic12
    $ cd weblogic-helloworld
    $ ant -lib $WEBLOGIC_HOME/wlserver/server/lib/weblogic.jar
    The built web application is now situated in output/helloWorldEar/helloWorldEar.war
  5. Test your WebService using the WebLogic Test Client
  6. Go to app.rookout.com and start debugging !

Rookout Integration explained

This example is based of the Java javalin "Hello-World" example available [here].

We have added Rookout to the original project by:

  1. Including source files and compiling with debug information in the ant task:

       <target name="build-service">
           <jwsc
                   srcdir="src"
                   destdir="${ear-dir}"
                   debug="true">
               <module name="${ear.deployed.name}">
                   <jws file="examples/webservices/hello_world/HelloWorldImpl.java"
                        type="JAXWS"/>
                   <zipfileset dir=".">
                       <include name="src/**"/>
                   </zipfileset>
               </module>
       
           </jwsc>
       </target>
  2. Downloading the Rookout Java Agent available on maven central:

        wget "http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=com.rookout&a=rook&v=LATEST"  -O rook.jar
  3. Specified the Rookout Java Agent in Weblogic startup script:

    • File location: WEBLOGIC_HOME/user_projects/domains/DOMAIN_NAME/bin/startWebLogic.sh

    • Find the line JAVA_OPTIONS="${SAVE_JAVA_OPTIONS} "

    • Append the Rookout SDK (aka "Rook") :

         JAVA_OPTIONS="${SAVE_JAVA_OPTIONS} -javaagent=ROOK_LOCATION/rook.jar"
    • Set your ROOKOUT_TOKEN:
         export ROOKOUT_TOKEN="<Your-Rookout-Token>"
You can’t perform that action at this time.