C
Installing Oracle9iAS Containers for J2EE (OC4J)

The appendix provides an overview and installation instructions for Oracle9iAS Containers for J2EE (OC4J).

Overview

OC4J is a J2EE container with a JVM that accepts HTTP and RMI connections. These connections access servlets, JSP Pages, and EJBs.

For more information, refer to the Oracle9iAS Containers for J2EE Getting Started on the Oracle9iAS Containers for J2EE CD-ROM, which is part of the Oracle9i Application Server CD pack.

Installing OC4J

This section provides installation instructions for OC4J. The topics include:

Requirements

The current release of OC4J is more stable when used with JDK version 1.2.2_07, or 1.3.xxx. We recommend that you use the JDK that comes with Oracle9i Application Server 1.0.2.2, which is JDK version 1.2.2_07.

However, for hosts with Windows NT, the Symantec JIT that ships with any Java2 environment can cause problems. To solve these problems, either upgrade to JDK version 1.3 or do not use the JDK release 1.2 Symantec JIT with the OC4J server.

Upgrading to JDK version 1.3--This is recommended, because disabling the JIT degrades performance.
Disabling Symantec JIT--If you decide to not use the Symantec JIT, start the OC4J server as follows:
```
java -Djava.compiler-none -jar orion.jar
```

You do not need to add anything to your CLASSPATH to run OC4J, because it loads the Java JAR and class files directly from the installation directory, from the lib/ subdirectory, and from the deployed applications EAR, WAR, or ejb-jar files.

Basic Installation

OC4J is distributed within a ZIP file named oc4j.zip on the Oracle9iAS Containers for J2EE CD-ROM. Unzip this file into the %ORACLE_HOME% directory where you installed the Oracle9i Application Server.

You must have a Java2 version Java executable in your %PATH%, preferably version 1.2.2_07. To install OC4J, unzip oc4j.zip into your Oracle home directory. For example, execute the following:

prompt> cd %ORACLE_HOME%
prompt> unzip oc4j.zip
prompt> cd %ORACLE_HOME%\j2ee\home
prompt> java -jar orion.jar -install

After the install is complete, the%ORACLE_HOME%\j2ee\home directory contains all the files necessary for running OC4J with a default configuration. The installation prompts you for an administration username and password, which is used for the administration console command-line tool.

Note:
OC4J is installed with the Sun Microsystems JDK version 1.2.2_07 tools.jar. However, if you receive a versioning problem because you use version 1.3, copy lib\tools.jar from your version of the JDK installation to the j2ee\home\ root installation directory.

Testing the Default Web Server

OC4J is installed with a default configuration that includes a default Web site and a default application. These are provided so you can start and test OC4J immediately.

Start OC4J by executing the following:

Change directory to the OC4J installation directory (j2ee\home), and issue one of the following commands:
- java -jar orion.jar
  
  This starts OC4J using the default configuration files.
- java -jar orion.jar -config drive:\mypath\server.xml
  
  This starts OC4J using the server.xml file located in \mypath.
You should get the following output:
```
Oracle9iAS (1.0.2.2) Container for J2EE initialized
```
Test OC4J by accessing "http://localhost:8888/" from a Web browser. If you changed the default port number, access the Web server using "http://localhost:portnumber/".

Test OC4J by accessing "http://localhost:8888/" from a Web browser. If you changed the default port number, access the Web server using "http://localhost:portnumber/".

For further instructions, including information on starting and stopping OC4J, refer to the Oracle9iAS Containers for J2EE Getting Started on the Oracle9iAS Containers for J2EE CD-ROM, which is part of the Oracle9i Application Server CD pack.

C Installing Oracle9iAS Containers for J2EE (OC4J)