FAQ #1 – How to configue the standalone WebLogic server for deploying ADF applications from JDeveloper 11g R1

Introduction

Installing and configuring the standalone WebLogic application server will allow us among others to manage our deployments and free up resources in JDeveloper by utilizing remote debugging.

Main Theme

Installation of WebLogic application server

If you have downloaded and installed JDeveloper Studio Edition, chances are that you have already installed WebLogic into your target environment. To verify that this is indeed the case, look for it either in the programs installed - for Windows OS under the Start menu bar - or by exploring the target installation directory.

If you have not installed WebLogic yet, do so by running the installation program. For complete installation instructions refer to  Installation Guide for Oracle JDeveloper.

Configuration of WebLogic application server

There two steps involved here: First to create a WebLogic domain and second to configure the domain to allow for deployment of ADF applications.

Create a new WebLogic domain

To create a new WebLogic domain use the Configuration Wizard utility installed in the Tools folder. In the Welcome screen select to Create a new WebLogic Domain and click Next.

In the Select Domain Source screen select Generate a domain configured automatically to support the following products and click on Oracle JRF – 11.1.1.0 [oracle_common] to install ADF support on the server. Click Next to go to the next screen.
 

In the Specify Domain Name and Location screen enter the name of the domain and its location on the disk. Click Next to go to the next screen.

In the Configure Administrator User Name and Password screen enter the domain administrator user name and password. Click Next to go to the next screen.

In the Configure Server Start Mode and JDK screen select Development Mode as the domain startup mode. For JDK select the JDK installed as part of the JDeveloper installation. Click Next to go to the next screen.

In the Select Optional Configuration screen select Administration Server and click Next. We could configure additional servers at this point however having a single server for both administration and deployments is good enough for now.

In the Configure the Administration Server screen verify the name and port of the administration server and click Next.

In the Configuration Summary screen verify the domain creation details. Click Create to create the WebLogic domain or Back to make any changes. When clicking on the Create button, the Configuration Wizard proceeds with the creation of the server domain.

Once the domain is created a User Projects shortcut is created under the Oracle Fusion Middleware 11.1.1.2.0 shortcut in the Start Menu. Beneath it, is yet another shortcut with the name of the domain we just created and shortcuts for starting, stoping and administering the domain.

Configure the domain to allow for deployment of ADF applications

In order to allow for the deployment of ADF applications there are a couple configuration changes that need to be done to the newly created domain. Edit the domain startup script startWebLogic.cmd and specify JVM options for starting the server in order to support ADF applications. The domain startup script can be located in the %MIDDLEWARE_HOME%\user_projects\domains\<domain_name>\bin directory, where %MIDDLEWARE_HOME% is the installation directory of WebLogic (and usually of JDeveloper) and <domain_name> is the name of the domain created previously.

Add the following lines before the set JAVA_OPTIONS= line:

set ADF_JAVA_OPTIONS=-Djrf.version=11.1.1 -Djrockit.optfile=%MIDDLEWARE_HOME%\modules\oracle.jrf_11.1.1\jrocket_optfile.txt

Edit the set JAVA_OPTIONS= line to read like the one below:

set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% %ADF_JAVA_OPTIONS%

Then update the CLASSPATH to include the following library %MIDDLEWARE_HOME%\modules\oracle.jrf_11.1.1\jrf.jar

We are ready now to start our newly created WebLogic domain. Just run the startWebLogic.cmd script to do so. You can create shortcuts on the desktop to make starting, stopping and administering the domain easily accessible.

Execute the startWebLogic.cmd script to start WebLogic and log onto the Admin Server Console. You can easily log onto the admin console by selecting the Admin Server Console from the Start Menu bar (Windows OS) - look under the Oracle Fusion Middleware 11.1.1.2.0 > User Projects > domain2 folder - or specifying http://localhost:7001/console in your browser. If you created the shortcuts on your desktop click the Admin Server Console instead.

Enter the username and password of the WebLogic administrator. You had specified the administrator credentials during the creation of the domain earlier. The default credentials are weblogic/weblogic1.

That’s it, we are up and running!

Conclusion

Installing and configuring the standalone version of WebLogic involves the creation of a WebLogic domain. In order to deploy ADF applications, the ADF libraries must be installed on the domain during its configuration. In addition a few more changes are needed in the startWebLogic.cmd script. Now we are ready to deploy and remote debug our application.

Until the next time, keep on JDeveloping!

References

http://technology.amis.nl/blog/6167/deploying-and-running-adf-11g-applications-on-weblogic-11g