Extending WebLogic Server for ADF Applications

No Gravatar

This post serves as a step by step guide to extending a generic WebLogic Server domain on Linux using the Application Development Runtime package available on OTN. The Application Development Runtime package includes the Java Required Files (JRF) which include the ADF runtime libraries necessary to deploy ADF applications on WLS. In case you’re wondering, these libraries are already included for the default domain that’s installed with JDeveloper, so that’s why no domain extension is necessary when you’re running an application directly from JDeveloper. However, if you’ve deployed an ADF application to your domain and are getting errors like “Unresolved application library references, defined in weblogic-application.xml: [Extension-Name: adf.oracle.domain, Implementation-Version:, exact-match: false], [Extension-Name: oracle.jsp.next, exact-match: false]“, then your domain doesn’t include the JRF extension and you’ll need to follow these steps.

1. From the Fusion Middleware Download page:

2. Scroll down to Application Development Runtime and click Disk1 to download.

3. Save the zip file to disk.

4. Open the zip once it has downloaded successfully and extract the files.

5. cd to the location of the files and run the installer:


6. If the installer prompts for a JDK, enter the one in the your Fusion Middleware home directory:


7. When the installer launches, select a directory for the inventory of the install:


8. If the installer was not run as root, the installer will prompt for the createCentralInventory.sh to be run before the install proceeds:


9. Run the script as directed:


The script should execute successfully.

10. Click OK in the installer dialog to continue the installation:


11. Click Next on the welcome page of the installer.

12. Click Next once the requirements are verified:


13. Specify the Oracle Fusion Middleware Home directory (where you have installed WLS 10.3) and click Next:

14. Click Install to start the installation:

15. Click Finish when the install is complete.

16. From the quick start dialog, launch the configuration wizard:

17. In the configuration wizard, select Extend an existing WebLogic domain and click Next:

18. Select the domain that you previously created and click Next:

19. Select Oracle JRF – [Oracle_APPDEV1] as the extension source and click Next:


20. Click Next to skip the Optional configurations steps:


21. Click Extend to extend the domain:


22. Click Done to exit the configuration wizard once the extension is applied successfully.

23. Finally, to ensure that the credentials that you supply in the database connections for your ADF Application are deployed and include the password, add -Djps.app.credential.overwrite.allowed=true to the JAVA_PROPERTIES entry in the FMW_HOME/user_projects/domains/yourdomain/bin/setDomainEnv.sh file (or setDomainEnv.cmd if you are on Windows), and restart the server using FMW_HOME/user_projects/domains/yourdomain/bin/startWebLogic.sh. This is what you need to do if you have deployed an ADF application to your server but are seeing the following errors when the application is accessed:

oracle.jbo.DMLException: JBO-26061: Error while opening JDBC connection.
at oracle.jbo.server.ConnectionPool.createConnection(ConnectionPool.java:253)
at oracle.jbo.server.ConnectionPool.instantiateResource(ConnectionPool.java:168)
at oracle.jbo.pool.ResourcePool.createResource(ResourcePool.java:546)
at oracle.jbo.pool.ResourcePool.useResource(ResourcePool.java:327)
at oracle.jbo.server.ConnectionPool.getConnectionInternal(ConnectionPool.java:104)
Truncated. see log file for complete stacktrace
java.sql.SQLException: ORA-01005: null password given; logon denied

Congratulations! Your WLS domain is now ready to host ADF applications.

7 Responses to 'Extending WebLogic Server for ADF Applications'

  1. Didier says:

    Hi Lynn,

    could you confirm that setting jps.app.credential.overwrite.allowed to true is valid in a Production environment ?

    The “Oracle Fusion Middleware Security Guide” states that it’s only valid in a development environment.
    URL: http://download.oracle.com/docs/cd/E12839_01/core.1111/e10043/devmancfg.htm#BCGJIJHH

    Thanks in advance,


  2. Lynn says:

    Correct, this setting is not valid in a Production environment (it will be ignored if set). If you are deploying to a WLS that was installed in production mode, JDBC data sources should be used in the app and configured in the server instead.

  3. Keith says:

    Just a quick note: after extending the domain, you need to bounce the WLS admin server before it gets picked up. I was tripped up on that for a good half hour or so. :)

  4. Bruce Kissinger says:

    Thanks! This was exactly what I was looking for

  5. Ganesh says:

    Thanks a lot . This helped me to deploy my app. Thanks again .

  6. Glorie says:

    Thank you for this useful description. Especially on the deloyment of ADF lib to WLS.

  1. [...] (and ADF 11g) Runtime Framework to the domain on which you want to deploy the ADF application (see: Extending WebLogic 11g for ADF applications by Lynn [...]

Leave a Reply

Your email address will not be published. Required fields are marked *


For spam filtering purposes, please copy the number 3008 to the field below: