Contents

List of Figures

List of Tables

Title and Copyright Information

Preface

Intended Audience

Documentation Accessibility

Related Documents

1 Introducing OC4J

J2EE Support in OC4J

What's New or Changed in OC4J

New Features in OC4J

Support for Web Services

Support for New J2EE 1.4 Application Management and Deployment Specifications

Support for Enterprise JavaBeans 3.0

Support for Oracle Application Server TopLink

OracleAS Job Scheduler

New Two-Phase Commit Transaction Coordinator Functionality

Generic JMS Resource Adapter Enhancements

Changes from Previous Releases

Configuration File Changes

What Is OC4J in a Standalone Configuration?

What Is OC4J in an Oracle Application Server Configuration?

Understanding the Application Hierarchy in OC4J

The System Application

The Default Application

The Global Web Application

J2EE Applications

2 Installing Standalone OC4J

Standalone OC4J Installation Prerequisites

Installing the Standalone OC4J Distribution

3 Tools for Administering OC4J

Oracle Enterprise Manager 10g Application Server Control Console

Accessing Application Server Control Console in Standalone OC4J

Accessing Application Server Control Console in Oracle Application Server

Functional Overview of the Application Server Control Console Interface

The admin_client.jar Command Line Utility

The admin.jar Command Line Utility

The oc4j/oc4j.cmd Executable Scripts

Oracle Process Manager and Notification Server (OPMN)

Changing the oc4jadmin Account Password

4 OC4J Runtime Configuration

Specifying the JDK Version

Specifying the JDK in a Standalone Configuration

Specifying the JDK in a Managed Configuration

Setting OC4J Runtime Options at Startup

Setting Runtime Options in a Standalone OC4J Configuration

Setting Runtime Options in a Managed OC4J Configuration

Overview of OC4J Runtime Options

Setting System Properties at Startup

Setting System Properties in a Standalone OC4J Configuration

Setting System Properties in an OPMN-Managed OC4J Configuration

Overview of General System Properties

Overview of Debug Properties

Managing stdout/stderr Log Files

5 Starting and Stopping OC4J

Starting OC4J in a Standalone Environment

Starting OC4J with oc4j.jar

Starting OC4J with oc4j/oc4j.cmd

Starting OC4J in an Oracle Application Server Environment

Stopping OC4J in a Standalone Environment

Stopping OC4J with admin.jar

Stopping OC4J with oc4j/oc4j.cmd

Stopping OC4J in an Oracle Application Server Environment

Restarting an OC4J Instance in a Standalone Environment

Restarting an OC4J Instance in an Oracle Application Server Environment

6 Using the admin_client.jar Utility

Overview of admin_client.jar Usage

Understanding the admin_client.jar Syntax and URI Specification

Performing Operations on a Group of OC4J Instances Within a Cluster

Performing Operations on a Specific OC4J Instance

Performing Operations on a Standalone OC4J Server

Validating a URI

Printing Usage Text to the Console

Enabling Logging

Deploying an Archive

Deploying a J2EE Application (EAR)

Deploying a Standalone Web Module (WAR)

Deploying a Standalone Resource Adapter (RAR)

Binding Web Modules to a Web Site Post-Deployment

Bind All Web Modules to a Single Web Site

Bind a Specific Web Module to a Specific Web Site and Set the Context Root

Redeploying an Archive

Undeploying an Archive

Undeploying an EAR or Standalone WAR

Undeploying a Standalone RAR

Updating Modified Classes Only in a Deployed EJB Module

Creating and Managing Shared Libraries

Installing a Shared Library

Modifying an Existing Shared Library

Viewing the Contents of a Shared Library

List All Shared Libraries

Starting/Stopping/Restarting an Application

7 Using the admin.jar Utility

Overview of admin.jar Usage

Understanding the admin.jar Syntax

Printing Help to the Console

Managing a Standalone OC4J Instance

Stopping and Restarting OC4J in a Standalone Environment

Forcing OC4J to Check for Modified Files

Deploying/Undeploying Applications

Managing Applications

Starting/Stopping/Restarting an Application

Updating an EJB Module Within an Application

Managing Web Sites

Managing Data Sources

Creating an Application-Specific Data Source

Listing/Testing/Removing Existing Data Sources

Converting Existing Data Sources to the New Configuration

Deploying/Undeploying Connectors

8 Configuring and Managing Clusters

Clustering Overview

How Clustering Works

Supported Clustering Models

Changes in Clustering

Configuring a Cluster

Configuring Dynamic Node Discovery Using Multicast

Configuring Multicast Discovery with opmnassociate

Configuring Multicast Discovery with opmnctl

Configuring Static Discovery Servers

Configuring a Static Discovery Server Connection with opmnctl

Configuring Cross-Topology Gateways

Configuring Static Node-to-Node Communication

Viewing the Status of a Cluster

Viewing Cluster Status with opmnctl

Viewing Cluster Status in Application Server Control Console

Load Balancing with Oracle HTTP Server

Using Web Server Routing IDs to Control OC4J Request Routing

Configuring Application Mount Points

Enabling Dynamic Configuration of Application Mount Points

Changing the Mount Point Configuration Algorithm

Viewing Mount Point Configuration Data

Replicating Changes Across a Cluster

Creating and Managing Additional OC4J Instances

Creating an Additional OC4J Instance

Accessing and Managing a New Instance

Removing an OC4J Instance

9 Application Clustering in OC4J

What Is Clustering in OC4J?

How Does Clustering Differ from Previous OC4J Releases?

"Islands" No Longer Supported

loadbalancer.jar No Longer Used

Deprecated Clustering-Specific XML Elements

Configuring Application Clustering

Enabling Clustering

Setting Replication Policies

Managing the Number of Nodes to Replicate To

Synchronous versus Asynchnronous Replication

Configuring Multicast Replication

Using an Existing JavaGroups Configuration for Multicast Replication

Configuring Peer-to-Peer Replication

Configuring Dynamic OPMN-Managed Peer-to-Peer Replication

Configuring Static Peer-to-Peer Replication

Configuring Database Replication

Disabling Clustering

Overview of the <cluster> Element

10 Logging in OC4J

Log Files Generated by OC4J

Using Plain Text File Logging

Enabling/Disabling Text File Logging

Managing Text Log Files

Viewing Text Log Files

Using Oracle Diagnostic Logging (ODL)

Enabling/Disabling ODL

Managing ODL Log Files

Viewing ODL Log Files

Configuring OC4J Logging

Using and Configuring the OC4J Component Loggers

Viewing the OC4J Log File

Configuring the oracle Logger

11 Task Manager and Thread Pool Configuration

Configuring the OC4J Task Manager

Using Thread Pools

Using the Default Thread Pool Configuration

Managing Thread Pool Configurations

12 Using MBeans in OC4J

MBeans and Java Management Extensions (JMX) Support in OC4J

What Are MBeans?

Overview of the Top-Level OC4J System MBeans

When Do Changes Made Via MBeans Take Effect?

How Is MBean Data Persisted?

Using the System MBean Browser

Using JMX Notifications

Subscribing to Notifications

Using Application-Specific MBeans

13 Managing Web Sites in OC4J

What Is a Web Site in OC4J?

Configuring Web Site Connection Data

Configuring Web Site Data in a Standalone OC4J Installation

Configuring Web Site Data in OPMN-Managed OC4J Instances

Configuring Web Sites with opmnctl

Creating a New Web Site in OC4J

Creating the Web Site Configuration File

Referencing the Web Site Configuration File in server.xml

Defining the Web Site Connection Data in opmn.xml

Sharing Web Applications Between Web Sites

Specifying the Cookie Domain

Configuring a Secure Web Site in OC4J

Creating the Secure Web Site Configuration File

Requiring Client Authentication

Requesting Client Authentication with OC4J

Starting/Stopping Web Sites

Configuring Web Site Access Logging

Configuring Text-Based Access Logging

Viewing Text Access Log Files

Configuring ODL Access Logging

Viewing ODL Access Log Files

Enabling/Disabling Access Logging for a Web Module/Application

14 Registering DTDs and XSDs with OC4J

Why Do DTDs/XSDs Have to Be Registered?

Registering a DTD or XSD

A Troubleshooting OC4J

Problems and Solutions

java.lang.OutOfMemory Errors

Application Performance Impacted by Garbage Collection Pauses

Invalid or Unneeded Library Elements Degrading Performance

ClassCastExceptions and ClassNotFound Errors

OC4J Fails to Start: Unable to Find Java Compiler

Error Occurs When Clustering an Application

Error When Downgrading from JDK 5.0 to JDK 1.4.2

OC4J Hangs When Starting Applications in Oracle Application Server

Need More Help?

B Configuration Files Used in OC4J

Overview of the XML Configuration Files Used by OC4J

Overview of the OC4J Server Configuration File (server.xml)

Example of a server.xml File

<application-server>

<execution-order>

<global-application>

<global-thread-pool>

<global-web-app-config>

<import-shared-library>

<j2ee-logging-config>

<java-compiler>

<javacache-config>

<shared-library>

<shutdown-class>

<startup-class>

<transaction-manager-config>

Overview of the Web Site Configuration Files (*-web-site.xml)

<default-web-app>

<user-web-apps>

<odl-access-log>

C Overview of the Session State Tables

D Third Party Licenses

The ANTLR License

The Apache Software License

Apache SOAP License

Perl Artistic License

FastCGI Developer's Kit License

Module mod_fastcgi License

Info-ZIP Unzip Package

The Info-ZIP Unzip Package License

The Jaxen License

The GNU License

mod_mm and mod_ssl

OpenSSL License

Perl Kit Readme

mod_perl 1.29 License

mod_perl 1.99_16 License

Perl Artistic License

The SAXPath License

The W3C License

Index