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: 22.214.171.124.0, 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 – 126.96.36.199 [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
yourdomain/bin/setDomainEnv.sh file (or setDomainEnv.cmd if you are on Windows), and restart the server using
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.
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.