Setting up a Fusion Applications Development Environment
By John 'Jb' Brock-Oracle on May 21, 2012
With the release of Oracle Fusion Applications, there has also been the release of the Fusion Application extensions for JDeveloper. Installing and configuring these extensions is referred to as the FA Dev Environment.
One very important thing to note, is that creating extensions for Oracle Fusion Applications, is NOT the same as writing extensions for JDeveloper. You are writing and extending the Application functionality, using JDeveloper as the dev environment.
With that said, I wanted to still cover this topic in this blog, because it involves the installation and configuration of JDeveloper Extensions that help with the customization of those Fusion Applications.
Hope that makes sense. :-)
Downloading the proper version of JDeveloper and the FA Extensions
The version of JDeveloper and the FA Extensions is directly related to what version of Oracle Fusion Applications you have installed on the servers. You get the different releases, from the eDelivery website, under product pack Oracle Fusion Applications .
DO NOT download a version of JDeveloper off of the OTN website and use it to setup the Fusion Applications Dev environment.
No matter which version you download, you will need two different downloads.
- JDeveloper installer (Oracle JDeveloper 11g and Oracle Application Development Framework 11g)
- Fusion Application Extensions Bundle (Oracle Fusion Applications Companion 11g)
Part#: V28727-01 :: Oracle Fusion Applications Companion 11g (18.104.22.168.3)
Part#: V28726-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (22.214.171.124.3) (Part 1 of 3)
Part#: V28726-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (126.96.36.199.3) (Part 2 of 3)
Part#: V28726-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (188.8.131.52.3) (Part 3 of 3)
Part #'s for FA V1 RUP2 on http://edelivery.oracle.com
Part#: V31524-01 :: Oracle Fusion Applications Companion 11g (184.108.40.206.1)
Part#: V31523-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (220.127.116.11.1) (Part 1 of 3)
Part#: V31523-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (18.104.22.168.1) (Part 2 of 3)
Part#: V31523-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (22.214.171.124.1) (Part 3 of 3)
Part#: V31981-01 :: Oracle Fusion Applications Companion 11g (126.96.36.199.2)
Part#: V31980-01 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (188.8.131.52.2) (Part 1 of 3)
Part#: V31980-02 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (184.108.40.206.2) (Part 2 of 3)
Part#: V31980-03 :: Oracle JDeveloper 11g and Oracle Application Development Framework 11g (220.127.116.11.2) (Part 3 of 3)
(Other releases that come out after this posting will be found in the same http://edelivery.oracle.com location, with newer part numbers. The naming should remain the same)
TIP: If you are installing on Windows only, you can just download the companion archive and Part 3 of 3 for the JDeveloper IDE. Part 1 is the .jar installer and Part 2 is the .bin installer for other operating systems.
Once you have the appropriate bits downloaded, and extracted, you can start the steps for getting everything installed and configured.
Installing JDeveloper and FA Dev Extensions
This is a pretty normal step. Just install JDeveloper as you would on any other machine. With one exception:
- Do not install JDeveloper into a path that contains spaces (the default is C:\Oracle\Middleware)
The entire process for setting the proper environment variables and setting up the Update Center for installing the FA Dev Extensions, is described in detail in the online documentation under the Setting Up Your Development Environment section.
A couple of things to watch for when setting up the environment listed in the docs.
- Do Not include the quotes " " around the values for USER_MEM_ARGS variable on Windows. This is a typo in the docs.
- It is best to use the JDK that ships with JDeveloper on Windows. You do not need to use a 64bit JDK. For other operating systems make sure you use something equal to or above jdk160_24
- When the docs tell you to change directories to $MW_HOME/jdeveloper/jdev/bin and run JDeveloper, this is mainly for non-Windows OS's. However if you do run on Windows from a command window it could allow you to see some of the error messages if there are any. You can still run JDev from the Start Menu if you like.
Configuring the Fusion Domain
Once you've installed the FA Dev Extensions, and restarted JDeveloper, you select either the "Oracle Fusion Applications Developer" or "Oracle Fusion Applications Administrator Customization" role at startup.
As you will see in step of 7 of the online documentation, you will now be prompted to configure the Weblogic Server. This involves filling out the Fusion Domain Configuration wizard and letting it do it's thing.
A couple of things to watch for before and during the running of the domain config wizard
- Make sure you have Python 2.7.2 or higher installed in a path that does not contain spaces.
- DO NOT use Python 3.x
- Take a look at your system PATH environment variable and remove any entries that have spaces in them
- The easiest way to do this on Windows is to open a command window and set the PATH variable to just contain "." and the path to your Python installation. (e.g. set PATH=.;c:\python272 )
- Then start JDeveloper from this command window
- When you run the Fusion Domain Configuration wizard, you will be given an option to test the connection to the application server on one of the pages. If it fails during the tests, but you know FOR SURE that you have the login credentials correct, try entering the IP address of the host instead of the hostname in the connection URL. We have seen some DNS issues cause errors during the test page.
Follow all of the tips above and you should get the domain configured and extended properly.
There are always exceptions to the rule. If you run into issues, try looking at these tips.
There are two different types of log files that can help find an answer to whatever issue you are running into. Server logs, and config logs
Some common error messages
"...\Java\jre6\lib\ext\QTJava.zip was unexpected at this time."
This error is usually caused by the QT entry in the CLASSPATH containing spaces. You can get around this by removing the Quicktime/QT entry from the end of the CLASSPATH
"... wlst create default authenticator failed"
"java.lang.IllegalArgumentException: java.lang.IllegalArgumentException: The provider OIDAuthenticator already exists"
"OracleScriptingException: The MBean oracle.wsm:*,name=WSMDocumentManager,type=Repository was not found."
All of the above errors, or errors similar that mention *wsm* are usually caused by the owsm_mds schema not existing. If you look at the Dev Guide, in section 18.104.22.168, it explains that this schema is usually not available in production or test databases. The Fusion install doesn't create it in the starter database; it's expected to be in the IDM database. Go back and read this section of the Dev Guide to install and configure the owsm_mds schema.
The configuration script seems to just hang while running "FADevConfigure.py"
If you followed the tips and hints above, you shouldn't hit this issue. However if you do, make sure you go back and check to see if you have quotes around any of your Windows environment variables, and if your PATH setting has spaces in it.
When testing your application server connection you see something like:
Testing JSR-160 Runtime ... failed
Cannot establish connection.
Testing JSR-160 DomainRuntime ... skipped
Testing JSR-88 ... skipped
Testing JSR-88-LOCAL ... skipped
Testing JNDI ... skipped
Testing JSR-160 Edit ... skipped
Testing HTTP ... success
Testing Server MBeans Model ... skipped
Testing App Controller ... success
This is usually solved by setting the IP address of the application server in the connection URL instead of the hostname.
With the tips and hints listed above, along with the common error messages in the troubleshooting section, you should be able to get up and running pretty quickly. If you run into other issues setting up the development environment, please don't hesitate to drop a comment below. Please DO NOT ask me questions about how to do the customization of the FA applications themselves. If you're trying to edit files, I'm not going to be the person to help you out with that.
Special Thanks to Oliver Steinmeier for a lot of the answers and troubleshooting of customer issues internally, so that we can compile these types of lists.