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:

Meeting Installation Prerequisites for a Standalone OC4J Server
Installing the Standalone OC4J Distribution

Meeting Installation Prerequisites for a Standalone OC4J Server

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

Install JDK 5.0 or 1.4.2

Before installing standalone OC4J, you must first install Java 2 Platform, Standard Edition (J2SE) Development Kit (JDK) release 5.0 or 1.4.2 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, JDK 5.0 is packaged with the server binaries.

Set Environment Variables

After installing J2SE, ensure that the JAVA_HOME and ORACLE_HOME environment variables are set. You can also set the J2EE_HOME environment variable.

Table 2-1 Environment Variable Settings

Environment Variable Value

Environment Variable	Value
`JAVA_HOME`	Set to the location of the JDK. This variable is required to start the OC4J server. For example: JAVA_HOME=/java/j2se15 The JDK that will be used must be added to the host machine's PATH environment variable.
`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 the `oc4j` or `oc4j.cmd` 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 `ORACLE_HOME/j2ee/home`, which will be the installed location of `admin_client.jar`, `oc4j.jar`, and `admin.jar`. The value of `ORACLE_HOME` is the root directory into which you will install the OC4J distribution. Setting the `J2EE_HOME` environment variable or the `oracle.j2ee.home` system property to the J2EE home directory enables you to invoke `admin_client.jar`, `oc4j.jar`, or `admin.jar` from any directory.

JAVA_HOME

Set to the location of the JDK. This variable is required to start the OC4J server. For example:

JAVA_HOME=/java/j2se15

The JDK that will be used must be added to the host machine's PATH environment variable.

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 the oc4j or oc4j.cmd 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 ORACLE_HOME/j2ee/home, which will be the installed location of admin_client.jar, oc4j.jar, and admin.jar. The value of ORACLE_HOME is the root directory into which you will install the OC4J distribution.

Setting the J2EE_HOME environment variable or the oracle.j2ee.home system property to the J2EE home directory enables you to invoke admin_client.jar, oc4j.jar, or admin.jar from any directory.

Instead of the environment variables ORACLE_HOME and J2EE_HOME, you can use the system properties oracle.home and oracle.j2ee.home to set the Oracle and J2EE home directories.

If you want to use a locale other than the default locale for the operating system, also set the LC_ALL and LANG environment variables, both to the same value.

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 document as ORACLE_HOME, using the archive utility of your choice. The installer automatically creates the required directory structure for you, as follows:

ORACLE_HOME
   /ant
   /bin
   /diagnostics
   /j2ee
   /javacache
   /javavm
   /jdbc
   /jlib
   /lib
   /opmn
   /rdbms
   /sqlj
   /toplink
   /webservices
   /xqs

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.

You can also activate the oc4jadmin account before starting OC4J, using the jazn.jar tool. This tool is 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 OC4J 10g (10.1.3.1.0).

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