Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Related Documents

1 Configuration and Deployment

1.1 Introduction to OC4J Standalone

1.2 OC4J Installation

1.2.1 Requirements

1.2.2 Basic Installation

1.2.3 Testing the Default Configuration

1.3 Starting and Stopping OC4J

1.3.1 Starting OC4J

1.3.2 Administering OC4J

1.3.2.1 Restarting OC4J

1.3.3 Shutting Down OC4J

1.3.4 HTTP and RMI Communication

1.3.5 Quick Start for JSPs and Servlets

1.4 Creating the Development Directory

1.5 Configuring the FAQ Application Demo

1.5.1 Environment Setup for FAQ Demo

1.5.1.1 Oracle Database

1.5.2 OC4J System Configuration for FAQ Demo

1.5.2.1 Data Source Configuration

1.5.2.2 Security Configuration

1.5.3 Deploy the FAQ Demo

1.5.3.1 Deploy Using Automatic Deployment in a Development Environment

1.5.3.2 Deploy Using the Admin.JAR Tool in All Environments

1.5.4 Deployment Details Explained

1.6 Deploying Applications

1.6.1 Archive Application into an EAR File

1.6.2 Deployment In a Production Environment Using ADMIN.JAR

1.6.2.1 Binding the Web Application

1.6.2.2 Deploy Your Application Manually in a Development Environment

1.6.3 Verifying Deployment

1.7 What Happens When You Deploy?

1.8 Undeploying Web Applications

2 Advanced Configuration and Development

2.1 Overview of OC4J and J2EE XML Files

2.1.1 XML Configuration File Overview

2.1.2 XML File Interrelationships

2.2 Sharing Libraries

2.3 Manually Adding Applications in a Development Environment

2.3.1 Configuring a Listener

2.3.2 Configuring J2EE Applications

2.4 Building and Deploying Within a Directory

2.5 OC4J Automatic Deployment for Applications

2.6 Changing XML Files After Deployment

2.7 Designating a Parent of Your Application

2.8 Developing Startup and Shutdown Classes

2.8.1 OC4J Startup Classes

2.8.2 OC4J Shutdown Classes

2.9 Setting Performance Options

2.9.1 Performance Command-Line Options

2.9.2 Thread Pool Settings

2.9.3 Statement Caching

2.9.4 Task Manager Granularity

2.10 Enabling OC4J Logging

2.10.1 Viewing OC4J System and Application Log Messages

2.10.1.1 Text Log Files

2.10.1.2 Oracle Diagnostic Logging (ODL) Log Files

2.10.2 Redirecting Standard Out and Standard Error

2.11 OC4J Debugging

2.11.1 Servlet Debugging Example

3 Configuring Security

3.1 Overview of Security Functions

3.2 Authentication

3.2.1 Specifying Users and Groups

3.2.1.1 Example: Specifying Users and Groups in jazn-data.xml

3.2.1.2 Example: Specifying Users and Groups in principals.xml

3.2.2 Authenticating HTTP Clients

3.2.3 Authenticating EJB Clients

3.2.3.1 Setting JNDI Properties

3.2.3.2 Using the Initial Context Factory Classes

3.3 Authorization

3.3.1 Specifying Logical Roles in a J2EE Application

3.3.2 Mapping Logical Roles to Users and Groups

3.4 Plugging In a User Manager

3.4.1 Using the JAZNUserManager Class

3.4.1.1 Using the JAZNUserManager Class with the LDAP-Based Provider Type

3.4.1.2 Using the JAZNUserManager Class with the XML-Based Provider Type

3.4.2 Using the XMLUserManager Class

3.4.3 Creating Your Own User Manager

3.5 Confidentiality Through SSL

3.5.1 Overview of Using SSL for OC4J Standalone

3.5.1.1 Overview of SSL Keys and Certificates

3.5.1.2 Using Certificates with OC4J Standalone

3.5.2 Configuration of OC4J for SSL

3.5.2.1 Requesting Client Authentication with OC4J Standalone

3.5.3 HTTPS Common Problems and Solutions

3.5.3.1 General SSL Debugging

A Troubleshooting OC4J

A.1 Problems and Solutions

A.1.1 Unable to Restart OC4J After Abnormal Termination When OracleAS JMS is Active

A.1.2 Stateful Replication Not Consistent Across OC4J instances

A.1.3 Using A Non-Certified Version of the JDK for OC4J Only

A.1.4 java.lang.OutOfMemory Errors Thrown When Running OC4J

A.1.5 Connection Timeouts Through a Stateful Firewall Affect System Performance

A.1.6 OPMN-Managed OC4J Unable to Access EJB Resources Via the Default RMI Port

A.1.7 Application Performance Impacted by Garbage Collection Pauses

A.1.8 Invalid or Unneeded Library Elements Degrade Performance

A.2 Need More Help?

B Additional Information

B.1 Description of XML File Contents

B.1.1 OC4J Configuration XML Files

B.1.1.1 server.xml

B.1.1.2 http-web-site.xml

B.1.1.3 jazn-data.xml

B.1.1.4 principals.xml

B.1.1.5 data-sources.xml

B.1.1.6 jms.xml

B.1.1.7 rmi.xml

B.1.2 J2EE Deployment XML Files

B.1.2.1 The J2EE application.xml File

B.1.2.2 The OC4J-Specific orion-application.xml File

B.1.2.3 The J2EE ejb-jar.xml File

B.1.2.4 The OC4J-Specific orion-ejb-jar.xml File

B.1.2.5 The J2EE web.xml File

B.1.2.6 The OC4J-Specific orion-web.xml File

B.1.2.7 The J2EE application-client.xml File

B.1.2.8 The OC4J-Specific orion-application-client.xml File

B.2 Elements in the server.xml File

B.2.1 Configure OC4J

B.2.2 Reference Other Configuration Files

B.2.2.1 <application-server> Element Description

B.2.2.2 Elements Contained Within <application-server>

B.3 Elements in the application.xml File

B.3.1 <application> Element Description

B.3.1.1 Elements Contained Within <application>

B.4 Elements in the orion-application.xml File

B.4.1 <orion-application> Element Description

B.4.1.1 Elements Contained Within <orion-application>

B.5 Elements in the application-client.xml File

B.5.1 <application-client> Element Description

B.5.1.1 <application-client>

B.5.1.2 Elements Contained Within <application-client>

B.6 Elements in the orion-application-client.xml File

B.6.1 <orion-application-client> Element Description

B.6.1.1 Elements Contained Within <orion-application-client>

B.7 Standalone OC4J Command-Line Options and Properties

B.7.1 Options for the OC4J Server JAR

B.7.2 Options for the OC4J Administration Management JAR

B.7.2.1 General OC4J Administration

B.7.2.2 Application Deployment

B.7.2.3 Adding Web Sites

B.7.2.4 DataSource And Application Options

B.8 OC4J System Properties

B.9 Configuration and Deployment Examples

B.9.1 J2EE Application XML Configuration Example

B.9.1.1 application.xml Example

B.9.1.2 web.xml Example

B.9.1.3 ejb-jar.xml Example

B.9.1.4 server.xml Addition

B.9.1.5 http-web-site.xml Addition

B.9.1.6 Client Example

B.9.1.7 Deploying Example

B.9.1.8 EJB Module

B.9.1.9 Web Module—Servlet and JSP Calling EJBs

B.9.1.10 Client Module—Standalone Java Client Invoking EJBs

C Third Party Licenses

C.1 Third-Party Licenses

C.1.1 Apache HTTP Server

C.1.1.1 The Apache Software License

Index