Oracle JHeadstart 10g for ADF

Installation Guide

Version 10.1.2.0

February 2005

Content

• Compatibility
• Installation
• Getting Started
• Upgrading from Previous Releases
• Known Issues

Compatibility

Oracle JHeadstart 10g Release 10.1.2.0.x has been certified with the following products:

• Oracle JDeveloper 10g Version 10.1.2.0.0 (on Windows or on Linux).
• ADF Business Components 10.1.2.17.96 (included with 10.1.2.0.0 release of JDeveloper)
• ADF UIX 2.2.16 (included with 10.1.2.0.0 release of JDeveloper)
• Jakarta Struts 1.1 Production (included with 10.1.2.0.0 release of JDeveloper)
• Application Server: see the Application Server Support Matrix
• Browser:
• • Internet Explorer 6.0
  • Mozilla Firefox 1.0
• Oracle Designer 6i, 9i or 10g (for JHeadstart Designer Generator). Future versions of Designer are compatible if there are no functional changes in the API of Designer.

Other versions of these products may be compatible, but have not been tested.

Installation

1. Unzip JHeadstart10.1.2.0.x.zip (using folder names) to a folder of your choice, for example C:\JHeadstart (in the next steps referred to as <JHeadstartHome>).
2. Find out in which folder JDeveloper 10.1.2 is installed (in the next steps referred to as <JDeveloperHome>).
3. In <JHeadstartHome>\config\jdevaddins you will find a number of JAR files, which need to be installed as plug-ins for JDeveloper. Create a new directory <JDeveloper_Home>\jdev\lib\ext\ jheadstart and copy the JAR files to that directory: You have now extended the JDeveloper 10g IDE with JHeadstart-specific functionality!
4. If you want to be able to use JHeadstart Designer Generator: in <JHeadstartHome>\config\jdevaddins you will also find a file named migration.xml. This file must be copied to the system directory of JDeveloper, for example: <JDeveloperHome>\jdev\system10.1.2.0.0.1811. On Linux this directory is in the home directory of the user that is running JDeveloper: $HOME/jdevhome/system10.1.2.0.0.1811. The exact name of this directory depends on the build number of JDeveloper.
5. As the last step, we have to tell the plug-ins where the JHeadstart Home is. Start JDeveloper 10.1.2, go to the menu option Tools - Preferences, select the category "JHeadstart Settings" and enter the JHeadstart Home. It should report a valid JHeadstart Home and show the version and build number.
   

Getting Started

Chapter 2 of the JHeadstart Developer's Guide explains how to get started with JDeveloper and how to create your own demo application. The JHeadstart Documentation Index has pointers to various other sources of information.

Here you can find a very short summary, for experienced JHeadstart/ADF users.

• Create a new Application Workspace, using the template "Web Application [default]". This will create a Model project for your Business Components, and a ViewController project for Struts and JSP/UIX.

• Create ADF Business Components in the Model project, using the JDeveloper wizards and editors.

• Then JHeadstart-enable the ViewController project by right-clicking the project and choosing "Enable JHeadstart". After JHeadstart-enabling the ViewController project, you can right-mouse-click the project and choose "JHeadstart Application Structure Wizard". In this wizard, you can select any ADF Business Components application module from all model projects included in your workspace to base your web application on.

• To generate a struts-config and pages using JHeadstart, right-click the Application Structure File and choose "Run JHeadstart Application Generator". Run the generated application by starting index.html (or by running the ViewController project).

See the Release Notes for all known bugs and issues with this release of Oracle JHeadstart 10g for ADF.