JHeadstart Blog

In the earlier post If you intend to deploy JHeadstart 10.1.3 to OracleAS 10.1.2 I explained which preparation steps to take if you are going to deploy your JHeadstart 10.1.3 application to an
application server that uses JDK 1.4 (like Oracle Application Server
10.1.2). I promised that in a later post I would blog about how to do the actual deployment.

Well, here it is! Below are the steps I took to successfully deploy a JHeadstart 10.1.3 application to Oracle AS 10.1.2 (after trying out several other methods). The steps are so generic that I think they can be used for any JDeveloper 10.1.3 web application using ADF Business Components and JSF or ADF Faces.

1. Create a new OC4J Instance in OracleAS 10.1.2 (for example from the Application Server Home Page).
2. Disable ADF Runtime for this OC4J instance by modifying its [OC4JInstanceHome]/config/application.xml (on the file system of the application server machine). Comment out the following lines:
   

<library path="../../../BC4J/lib"/>
<library path="../../../jlib/ojmisc.jar"/>
<library path="../../../ord/jlib/ordim.jar"/>
<library path="../../../ord/jlib/ordhttp.jar"/>
<library path="../../../jlib/jdev-cm.jar"/>

and


<library path="../../../uix/taglib"/>

3. If necessary, set up Data Sources and other configuration settings for OC4J.
4. In the ViewController project properties, go to Libraries.
   
5. Add the following libraries that are needed for the Model project:
      BC4J Oracle Domains
      Oracle JDBC
      SQLJ Runtime
6. Also add or create any other libraries where needed to get the right jar files in the EAR file.
   
7. In the ViewController project, create a new WAR Deployment Profile (File | New | General | Deployment Profiles | WAR File).
8. In the deployment profile properties, go to WEB-INF/lib Contributors, and select all the libraries (except JSP Runtime).
9. In the deployment profile properties, go to WAR Options, and select Compress Archive.
10. If you use Subversion, go to all Filters categories, then to Patterns, and exclude **/.svn/
11. In web.xml, replace

<web-app
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"  
version="2.4"  
xmlns="http://java.sun.com/xml/ns/j2ee">

by

<!DOCTYPE web-app PUBLIC  
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"  
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>

12. On your development PC, install JDK 1.4 (for example, copy the jdk folder from a JDeveloper 10.1.2 home).
13. In the ViewController Project Properties, go to Libraries.
14. Click the Change button for the J2SE Version.
15. Click the New button to create a new J2SE Definition.
16. Browse to your [JDK1.4Home]/bin/java.exe for the J2SE Executable.
17. When asked to install OJVM, click OK.
18. Accept the default settings for name, class path, source path, and doc path.
19. Choose if you want to define the new J2SE definition at Project level (every deployer needs to have JDK 1.4 in same path), or User level (every deployer needs to create own J2SE definition).
20. Save the settings.
    Warning: after this step (usage of J2SE 1.4), do not try to run Embedded OC4J (see below how to enable Embedded OC4J again).
21. In the Model Project Properties, do the same (define a similar J2SE 1.4 Version).
    
22. Empty your classes folder (the output directory for the compiler). You can do that in JDeveloper via the menu option Run - Clean ViewController.jpr.
    
23. Right-click the deployment profile and choose Deploy to EAR. The log tells you where it creates the EAR file.
    
24. Deploy the EAR file to the new OC4J instance (see this documentation).
    

• In both the Model and the ViewController Project Properties, go to the Libraries page, and change the J2SE Version to 1.4 (which is now already defined).
• Empty your classes folder (the output directory for the compiler). You can do that in JDeveloper via the menu option Run - Clean ViewController.jpr.
• Right-click the deployment profile and choose Deploy to EAR.
• Deploy the EAR file in the new OC4J instance.
• Change the J2SE Version back to 1.5 (in both Model and ViewController).