Contents

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documentation
• Conventions

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.6.4 Impact of Undeploying/Redeploying an Application
  • 1.6.5 Impact of "Hot Deploying" an Application
• 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.10.3 Disabling Access Logging for a Web Application
• 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 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 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