Skip Headers
Oracle® Application Server Containers for J2EE User's Guide
10
g
Release 2 (10.1.2)
Part No. B14011-02
Library
Product
Index
Next
Contents
Title and Copyright Information
Preface
Intended Audience
Documentation Accessibility
Related Documentation
Conventions
1
OC4J Overview
1.1
Introduction to OC4J
1.1.1
Examples Provided with OC4J
1.2
JDK 1.4 Considerations: Cannot Invoke Classes Not in Packages
1.2.1
Migrating Source Code from JDK 1.4 to JDK 1.3
1.2.2
Migrating Source Code from JDK 1.3 to JDK 1.4
1.3
Navigating the OC4J Documentation Set
1.4
OC4J Installation
1.5
Using OC4J in an Enterprise or Standalone Environment
1.5.1
Managing Multiple OC4J Instances in an Enterprise Environment
1.5.2
Managing a Single OC4J Instance
1.5.3
Using JDK With OC4J
1.5.4
OC4J Documentation Set Assumptions
1.6
OC4J Communication
1.6.1
HTTP Communication
1.6.2
Requirements
2
Configuration and Deployment
2.1
OC4J Home Page Overview
2.1.1
Applications Page
2.1.2
Administration Page
2.2
Starting and Stopping OC4J
2.2.1
Testing the Default Configuration
2.3
Creating the Development Directory
2.4
Configuring the FAQ Application Demo
2.4.1
Environment Setup for FAQ Demo
2.4.1.1
Oracle Database
2.4.2
OC4J System Configuration for FAQ Demo
2.4.2.1
Data Source Configuration
2.4.2.2
Security Configuration
2.4.3
Deploy the FAQ Demo
2.4.4
Deployment Details Explained
2.5
Deploying Applications
2.5.1
Basic Deployment
2.5.1.1
Select Application
2.5.1.2
Provide The URL Mappings For All Web Modules
2.5.1.3
IIOP Stub Generation
2.5.1.4
Provide Any Resource Reference Mappings
2.5.1.5
Specify Any User Manager
2.5.1.6
Provide Any Security Role Mappings
2.5.1.7
Publish Web Services
2.5.1.8
Deployment Review
2.5.1.9
Post-Deployment Application Modifications
2.5.2
Impact of Undeploying/Redeploying an Application
2.5.3
Impact of "Hot Deploying" an Application
2.6
What Happens When You Deploy?
2.6.1
OC4J Tasks During Deployment
2.6.2
Verifying the Configuration of Deployed J2EE Applications
2.7
Recovering From Deployment Errors
2.8
Undeploying Web Applications
3
Advanced Configuration and Development
3.1
Configuring OC4J Using Enterprise Manager
3.1.1
OC4J Instance Level Configuration
3.1.1.1
Configuring Server Properties
3.1.1.2
Configure a Web Site
3.1.1.3
Configure JSP Container Parameters
3.1.1.4
Configure Replication Parameters
3.1.1.5
Advanced Configuration Through XML Files
3.1.1.6
Configure Data Sources
3.1.1.7
Configure Security
3.1.1.8
Configure JMS
3.1.1.9
Configure Global Web Application Parameters
3.1.1.10
Configure RMI
3.1.2
Application Level Configuration
3.1.2.1
Configuring Application General Parameters
3.1.2.2
Configuring Local J2EE Services
3.1.2.3
Modifying XML Files Included in the Deployed Application EAR File
3.2
Overview of OC4J and J2EE XML Files
3.2.1
XML Configuration File Overview
3.2.2
XML File Interrelationships
3.3
Sharing Libraries
3.4
Understanding and Configuring OC4J Listeners
3.4.1
HTTP Requests
3.4.2
RMI Requests
3.4.3
Disabling Access Logging for a Web Application
3.5
Configuring Oracle HTTP Server With Another Web Context
3.6
Building and Deploying Within a Directory
3.7
Developing Startup and Shutdown Classes
3.7.1
OC4J Startup Classes
3.7.2
OC4J Shutdown Classes
3.7.3
Considerations for Startup and Shutdown Classes
3.8
Setting Performance Options
3.8.1
Performance Command-Line Options
3.8.2
Thread Pool Settings
3.8.3
Statement Caching
3.8.4
Task Manager Granularity
3.9
Enabling OC4J Logging
3.9.1
Viewing OC4J System and Application Log Messages
3.9.1.1
Oracle Diagnostic Logging (ODL) Log Files
3.9.1.2
Text Log Files
3.9.2
Redirecting Standard Out and Standard Error
3.10
OC4J Debugging
3.10.1
Servlet Debugging Example
3.10.2
Remote Debugging Using Oracle JDeveloper
4
OC4J Clustering
4.1
The OC4J Instance in a Cluster
4.1.1
The OC4J Process in a Cluster
4.1.1.1
Replicating Application State
4.1.2
Islands
4.1.3
J2EE Applications Involved in a Cluster
4.2
Instance-Specific Parameters
4.3
OC4J Clustering Examples
4.3.1
Software Failure
4.3.2
Hardware Failure
4.3.3
State Replication
4.4
OC4J Cluster Configuration
4.4.1
OC4J Instance Configuration
4.4.1.1
Configuring Islands and Processes
4.4.1.2
Configuring Web Application State Replication
4.4.1.3
Configuring EJB Application State Replication
4.4.2
Configuring OC4J Instance-Specific Parameters
A
Troubleshooting OC4J
A.1
Problems and Solutions
A.1.1
Unable to Start OC4J When Using JDK 1.3
A.1.2
Unable to Restart OC4J After Abnormal Termination When OracleAS JMS is Active
A.1.3
Stateful Replication Not Consistent Across OC4J instances
A.1.4
Using A Non-Certified Version of the JDK for OC4J Only
A.1.5
java.lang.OutOfMemory Errors Thrown When Running OC4J
A.1.6
Connection Timeouts Through a Stateful Firewall Affect System Performance
A.1.7
OPMN-Managed OC4J Unable to Access EJB Resources Via the Default RMI Port
A.1.8
Application Performance Impacted by JVM Garbage Collection Pauses
A.1.9
Invalid or Unneeded Library Elements Degrade Performance
A.1.10
JSP Error: Tag Not Registered
A.1.11
JSP Error: Zero-Length Class File
A.1.12
JSP Error: Illegal use of <when>-style tag without <choose> as its direct parent
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
default-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
Configuration and Deployment Examples
B.7.1
Configuration File Examples
B.7.1.1
application.xml Example
B.7.1.2
web.xml Example
B.7.1.3
ejb-jar.xml Example
B.7.1.4
server.xml Addition
B.7.1.5
default-web-site.xml Addition
B.7.1.6
Client Example
B.7.1.7
Client Module—Standalone Java Client Invoking EJBs
B.8
OC4J Command-Line Options and System Properties
C
Third Party Licenses
C.1
Third-Party Licenses
C.1.1
Apache HTTP Server
C.1.1.1
The Apache Software License
Index
