Page History

Download

# Go to the [*Oracle Internet Application Server*|http://www.oracle.com/technetwork/middleware/ias/overview/index.html] site.  Click on the [*Downloads*|http://www.oracle.com/technetwork/middleware/ias/downloads/index.html] tab and all available [*Application Server 10g Release 3 (10.1.3.x) Downloads*|http://www.oracle.com/technetwork/middleware/ias/downloads/index.html] will be displayed.
\\
\\
# Scroll down until you reach the *Oracle Containers for J2EE* section and click on [*Pure Java*|http://www.oracle.com/technetwork/middleware/ias/downloads/utilsoft-090603.html].  The [*Oracle Application Server 10g Software Downloads*|http://www.oracle.com/technetwork/middleware/ias/downloads/utilsoft-090603.html] will be displayed.
\\
\\
# Accept the License Agreement, then click on the *Oracle Containers for J2EE 10g (OC4J)* link.  The download of the *oc4j_extended_101350.zip* file will start.  Save this zip file on your workstation.

Install

# In your $\{user.home} directory, create the directories oc4j/10.1.3.5.0 and unzip the *oc4j_extended_101350.zip* file to the $\{user.home}/oc4j/10.3.5.0 directory.  Create a system environmental variable *ORACLE_HOME* and set it's value to $\{user.home}/oc4j/10.3.5.0.
\\
\\
For example: if *$\{user.home}=/users/rstone*, then *ORACLE_HOME=/user/rstone/oc4j/10.1.3.5.0*
\\
\\
You can actually unzip to any directory you desire.  The only requirement is that all directory names cannot contain any white space.
\\
\\
For MAC users:  You can now download a nice plugin that helps you manage your system environmenal variables.
a nice little plugin that help you manage your system environmental variable, you

Configure

1. Edit the file ${ORACLE_HOME}/j2ee/home/config/system-application.xml and change:

   Code Block
   <import-shared-library name="oracle.toplink">

   to:

   Code Block
   <!--import-shared-library name="oracle.toplink"-->

2. We need to add a datasource so that the applications can pull data from the database.  Edit ${ORACLE_HOME/j2ee/home/config/data-sources.xml to add a datasource.  Here's an example of adding a MITSIS datasource:
   

   Code Block
   <data-source class="com.evermind.sql.DriverManagerDataSource" name="OracleDS2" location="jdbc/MitsisDS" xa-location="jdbc/xa/StargateXADS-unused" ejb-location="jdbc/OracleDS-unused" connection-driver="oracle.jdbc.driver.OracleDriver" username="" password="" url="jdbc:oracle:thin:@//earth-vault-2.mit.edu:1523/sundev2" inactivity-timeout="30" />

   where obviously you MUST add your username and password.  If you do not have a username and password, request a them from your team leader.
   
   
3. FOR WINDOWS ONLY - setting the administrator's password
   
   Open a CMD window and cd to the ${ORACLE_HOME}/bin directory. Type the following command:
   

   Code Block
   oc4j -start

   You will be asked to enter and confirm a password.  Pick a password that is easy for you to remember.  You will need to use this password when configuring Maven.
   
   
4. In order to use Spring 3.X with OC4J 10.1.3, you'll need to swap out the default XML parser in OC4J with something more modern.  xercesImpl.jar and xml-apis.jar work fine.  To swap the parser out, you need to create a new shared library in the OC4J enterprise manager and then edit the system-application.xml file to use your new shared library instead of the Oracle XML parser.
   
   Start and stop the OC4J server.
   
   Open ${ORACLE_HOME}/j2ee/home/application-deployments/default/orion-application.xml with a text editor.  If the file or any sub-directory does not exist, create them as needed.
   
   If you had to create the file anew, these are the contents of the file:

   Code Block

   <?xml version='1.0' encoding='utf-8'?> <orion-application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://xmlns.oracle.com/oracleas/schema/orion-application-10_0.xsd" schema-major-version="10" schema-minor-version="0" component-classification="internal"> <imported-shared-libraries> <remove-inherited name="oracle.xml"/> </imported-shared-libraries> </orion-application>

   If you had an existing file, add this block to it:

   Code Block
   <imported-shared-libraries> <remove-inherited name="oracle.xml"/> </imported-shared-libraries>

   
   
5. FOR ALL OPERATING SYSTEMS - how to change the administrator password.
   
   Open ${ORACLE_HOME}/j2ee/home/config/system-jazn-data.xml with a text editor.
   
   Find the <user> tag block for oc4jadmin.  Change the oc4jadmin's <credentials> property to (substituting your password for myNewPassowd):

   Code Block
   <credentials>!myNewPassword</credentials>

   Be sure to preface the password with an ! to inidcate that this is a plain text value.
   
   When completed, the oc4jadmin <user> should look something like:

   Code Block
   <user> <name>oc4jadmin</name> <display-name>OC4J Administrator</display-name> <guid>E33D5A508AA511DF8F573778FB23EDF8</guid> <description>OC4J Administrator</description> <credentials>!myNewPassword</credentials> </user>

   Save the changes and restart the OC4J server.