2 Installing Standalone OC4J

This chapter describes the prerequisites and process for installing the OC4J standalone distribution, which is distributed as the as oc4j_extended.zip archive.

For instructions on installing OC4J as a component of Oracle Application Server, see the platform-specific Oracle Application Server Installation Guide.

The following topics are covered in this chapter:

Standalone OC4J Installation Prerequisites
Installing the Standalone OC4J Distribution

Standalone OC4J Installation Prerequisites

Ensure the following prerequisites are met before installing a standalone OC4J server.

Install JDK 1.4.2 or 5.0

Before installing standalone OC4J, you must first install Java 2 Platform, Standard Edition (J2SE) Development Kit (JDK) release 1.4.2 or 5.0 on the OC4J host machine. You can download the JDK release from http://java.sun.com/j2se/.

Note:

For standalone OC4J, the JDK must be provided; for OPMN-managed OC4J, the JDK 5.0 is packaged with the server binaries.

Set Environment Variables

After installing J2SE, ensure that the following environment variables are set:

Table 2-1 Environment Variable Settings

Environment Variable	Value
`JAVA_HOME`	Set to the location of the JDK. This variable is required to start the OC4J server. Note that the JDK that will be used must be added to the host machine's PATH.
`ORACLE_HOME`	Set to the root directory into which you will install the OC4J distribution. Defining this variable is required if you intend to run an `oc4j.cmd` or `oc4j.sh` executable script. For example, if you install OC4J into `C:\oracle`, set the value of the `ORACLE_HOME` variable to this directory.
`J2EE_HOME`	Optionally create and set this variable to `oc4j_install_dir/j2ee/home`, the installed location of `oc4j.jar` and `admin.jar`. Setting this variable will allow you to invoke these JAR files from any directory.

Installing the Standalone OC4J Distribution

Install the standalone OC4J distribution by extracting the oc4j_extended.zip file into the directory that will serve as the OC4J installed directory - referenced in this documentation as ORACLE_HOME - using the archive utility of your choice. The installer automatically creates the required directory structure for you, as shown below.

ORACLE_HOME
   /bin
   /j2ee
   /javacache
   /javavm
   /jdbc
   /jdk
   /jlib
   /lib
   /rdbms
   /soap
   /sqlj
   /toplink
   /webservices

You will be prompted to set a password for the OC4J Administrator account the first time OC4J is started. The user name for this account is set to oc4jadmin by default.

Note that you can also activate the oc4jadmin account before starting OC4J using the jazn.jar tool. This tool is also located in the ORACLE_HOME/j2ee/home/ directory. The syntax is as follows:

jazn.jar -activateadmin password

Note:

The oc4j.jar -install command, previously used to activate the oc4jadmin account as well as set the password for this account, is deprecated in Oracle Containers for J2EE 10g Release 3 (10.1.3).

The OC4J standalone distribution is installed with a default configuration that includes a default Web site where applications can be accessed, and a Web site that allows the Application Server Control management interface to be used. These are provided so that you can start using OC4J immediately. See Chapter 13, "Managing Web Sites in OC4J" for additional information.