Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Getting Started

• Overview of Deployment in OC4J
  • Valid Components for Deployment
  • Support for the J2EE Application Deployment API (JSR-88) in OC4J
  • Hot Deployment in OC4J
    • Deployment of Applications
    • Deployment of Shared Libraries
• Options for Deploying Applications to OC4J
  • Application Server Control User Interface
  • OC4J Ant Tasks
  • The admin_client.jar Command-Line Utility
  • The admin.jar Command-Line Utility
  • Oracle JDeveloper

2 Deploying and Undeploying J2EE Applications in OC4J

• Overview of the Application Deployment Process
  • Designating a Parent Application
  • Binding a Web Application to a Web Site
  • Creating or Applying a Deployment Plan
  • Using Dynamic HTTP Server Mount Points in Oracle Application Server
  • Impact of JDK Version on Deployed Applications
  • Example of a Deployed Application Directory Structure
• OC4J Application Deployment Process
• Overview of Redeploying an Application
  • Restart of OC4J After RMI or Manual Reconfiguration
  • Impact of Redeploying a Parent Application
• Overview of Undeploying an Application
  • Results of Removing an Application from OC4J
  • Impact of Undeploying a Parent Application
  • Results of Errors in Deployment Descriptors

3 Deploying Enterprise JavaBeans Modules

• Overview of EJB Deployment
• Generation of Client-Side IIOP Stubs
  • Generating Stubs with Application Server Control
  • Generating Stubs with admin_client.jar
  • Generating Stubs with the OC4J Ant Tasks
• Incremental Redeployment of Updated EJB Modules
• Impact of EJB Redeployment on Application Clients
  • Impact of Redeploying Session Beans
    • Stateless Session Beans
    • Stateful Session Beans
  • Impact of Redeploying Entity Beans
    • Bean-Managed Persistence Beans
    • Container-Managed Persistence Beans

4 Deploying Large Applications

• Specifying the Compilation Mode to Use
• Configuring the Java Compiler
  • Specifying an Alternative Java Compiler
  • Configuring Out-of-Process or In-Process Compiler Execution
  • Summary of Java Compiler Configuration Parameters
• Tuning the OC4J JVM for Large Deployments

5 Deploying Web Modules

• Deploying a Standalone Web Module
• Redeploying a Standalone Web Application
• Redeploying an Updated Web Module into an Existing Application
• Adding or Modifying JavaServer Pages in an Active Web Module
• Setting JSP Configuration Parameters in the XML Configuration File

6 Deploying Resource Adapters

• Deploying a Standalone RAR
  • Deploying a Resource Adapter with Dependencies
  • Deploying Multiple Versions of a Standalone RAR
• Redeploying or Undeploying a Standalone RAR

7 Deploying Web Services

• Deploying a Web Service
• Redeploying a Web Service

8 Working with Deployment Plans

• Deployment Plan Overview
  • How Deployment Plans Interact with Packaged Deployment Descriptors
  • Overview of J2EE and OC4J Deployment Descriptors
• Creating or Editing a Deployment Plan
  • Creating or Editing Deployment Plans with Application Server Control
  • Creating or Editing Deployment Plans with Oracle JDeveloper
• Setting Properties in a Deployment Plan
  • Setting J2EE Application Configuration Properties
  • Setting Web Module Configuration Properties
  • Setting Enterprise JavaBeans Module Configuration Properties
    • Setting General EJB Properties
    • Setting Entity Bean Properties
    • Setting Session Bean Properties
    • Setting Message-Driven Bean Properties
  • Setting Web Services Configuration Properties
    • Setting General Web Services Properties
    • Setting Web Service Description Properties
  • Setting Application Client Configuration Properties
  • Setting Resource Adapter Properties

9 Using Application Server Control for Deployment

• Accessing Application Server Control
  • Accessing Application Server Control in Standalone OC4J
  • Accessing Application Server Control in Oracle Application Server
• Setting Log Levels
• Deploying an Application to an OC4J Instance or Group of Instances
  • Deploying or Redeploying an Application
  • Redeploying an Application with Scheduled Jobs
  • Completing Configuration Tasks Before Deployment
    • Selecting the Security Provider
    • Mapping Security Roles to Users and User Groups
    • Configuring Enterprise JavaBeans Modules Included in the Application
    • Managing Class Loading to Import Shared Libraries
    • Configuring Application Clustering
    • Providing Resource Mappings
• Deploying a New Application Version with Side-by-Side Application Upgrade
  • How to Create an Additional HTTP Listener in an OC4J Instance
  • How to Deploy an Application with Side-by-Side Application Upgrade
• Undeploying an Application
• Creating and Managing Shared Libraries
• Starting, Restarting, and Stopping Applications
• Restarting and Stopping OC4J Instances
• Managing Data Sources and Connection Pools for OC4J Instances
• Managing JMS Resources

10 Using OC4J Ant Tasks for Deployment

• Preparing to Use OC4J Ant Tasks
  • Meeting Prerequisites for Using OC4J Ant Tasks
  • Incorporating OC4J Ant Tasks into Your Environment
  • Incorporating OC4J Ant Tasks Using Ant 1.6.5 Outside OC4J
  • Incorporating OC4J Ant tasks Using Ant 1.6.5 with the Administrative Client Utility
  • Setting the Deployer URI
    • Invoking a Task on a Group of OC4J Instances
    • Invoking a Task on a Specific OC4J Instance
    • Invoking a Task on a Standalone OC4J Server
  • Enabling Java Logging
  • Invoking OC4J Ant Tasks
• 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 After Deployment
  • Binding All Web Modules to a Single Web Site
  • Binding a Specific Web Module to a Web Site and Setting the Context Root
• Redeploying an Archive
  • Specifying a Delay Between Sequential Redeployments in a Cluster
  • Redeploying an Application with Scheduled Jobs
• Undeploying an Archive
• Updating Modified Classes in a Deployed EJB Module
• Creating and Managing Shared Libraries
  • Installing a Shared Library
  • Modifying an Existing Shared Library
  • Removing a Shared Library
• Starting, Restarting, and Stopping Applications
• Restarting and Stopping OC4J Instances
• Managing Data Sources
  • Adding, Testing, and Removing Data Source Connection Pools
    • Adding a Data Source Connection Pool
    • Testing a Data Source Connection Pool
    • Removing a Data Source Connection Pool
  • Adding, Testing, and Removing Data Sources
    • Adding a Managed Data Source
    • Removing a Managed Data Source
    • Adding a Native Data Source
    • Removing a Native Data Source
    • Testing a Database Connection
    • Testing a Data Source
    • Getting the Data Sources Descriptor for an Application
• Managing JMS Resources
  • Managing JMS Connection Factories
    • Adding a JMS Connection Factory
    • Removing a JMS Connection Factory
    • Getting Information About JMS Connection Factories
  • Managing JMS Destinations
    • Adding a JMS Destination
    • Removing a JMS Destination
    • Getting Information About JMS Destinations

11 Using the admin_client.jar Utility for Deployment

• Preparing to Use admin_client.jar
  • Understanding the admin_client.jar Syntax and URI Specification
    • Deploying to a Group of OC4J Instances Within a Cluster
    • Deploying to a Specific OC4J Instance
    • Deploying to a Standalone OC4J Server
    • Validating a URI
  • Downloading and Extracting the Remote Administration Client
  • Printing Usage Text to the Console
  • Enabling Logging
• Deploying an Archive
  • Deploying a J2EE Application (EAR)
  • Deploying a J2EE Application from a Remote Client
  • Deploying a Standalone Web Module (WAR)
  • Deploying a Standalone Resource Adapter (RAR)
  • Using a Script File for Batch Deployment
• Binding Web Modules to a Web Site After Deployment
  • Binding All Web Modules to a Single Web Site
  • Binding a Specific Web Module to a Web Site and Setting the Context Root
• Redeploying an Archive
  • Specifying a Delay Between Sequential Redeployments in a Cluster
  • Redeploying an Application with Scheduled Jobs
• Undeploying an Archive
  • Undeploying an EAR or Standalone WAR
  • Undeploying a Standalone RAR
• Updating Modified Classes 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
  • Listing All Shared Libraries
  • Removing a Shared Library
• Starting, Restarting, and Stopping Applications
• Restarting and Stopping OC4J Instances
  • Restarting an OC4J Instance or Group of Instances
  • Stopping an OC4J Instance or Instances
• Managing Data Sources
  • Adding, Testing, and Removing Data Source Connection Pools
    • Adding a Data Source Connection Pool
    • Testing a Data Source Connection Pool
    • Removing a Data Source Connection Pool
  • Adding, Testing, and Removing Data Sources
    • Adding a Managed Data Source
    • Removing a Managed Data Source
    • Adding a Native Data Source
    • Removing a Native Data Source
    • Testing a Database Connection
    • Testing a Data Source
    • Getting the Data Sources Descriptor for an Application
• Managing JMS Resources
  • Managing JMS Connection Factories
    • Adding a JMS Connection Factory
    • Removing a JMS Connection Factory
    • Getting Information About JMS Connection Factories
  • Managing JMS Destinations
    • Adding a JMS Destination
    • Removing a JMS Destination
    • Getting Information About JMS Destinations
• Managing OC4J Through a Remote Client
  • Using admin_client.jar Commands Remotely
  • Connecting to a Remote Oracle Application Server Instance Using JConsole
  • Using a JMX Programmatic Client to Manage OC4J Remotely

12 Deploying to Standalone OC4J with admin.jar

• Understanding the admin.jar Syntax
• Deploying or Redeploying an Application
• Undeploying an Application
• Updating an EJB Module Within a Deployed Application
• Deploying or Redeploying a Standalone Connector
• Undeploying a Standalone Connector

13 Deploying Web Applications from Eclipse

• Deploying a Web Application with the Web Tools Platform
  • Connecting to OC4J from Eclipse
  • Building a Web Application
  • Deploying a Web Application
• Using Ant Tasks from the OC4J Administration Client with Eclipse

14 Using Automatic Deployment in OC4J

• Overview of Automatic Deployment in OC4J
  • Exploded-Directory Deployment
  • Redeployment of Updated Files As Needed
  • When to Use Automatic Deployment
• Using Exploded-Directory Deployment for Application Development and Testing
  • Building and Deploying a J2EE Application from a Master Directory
  • Cloning an Application Module to an Exploded Directory
  • Reloading Modified Classes from an Exploded Directory
• Using an Auto-Deployment Directory
• Using the Check-for-Updates Feature
  • Enabling or Disabling Check for Updates
  • Redeploying Configuration Files, Deployment Descriptors, and WAR Files Automatically
    • Impact of Redeploying a Modified Configuration File Automatically
    • Impact of Redeploying a Modified Deployment Descriptor Automatically
    • Impact of Redeploying Modified Files in a War Automatically
• Forcing a One-Time Redeployment Using admin.jar

15 Troubleshooting Deployment Errors

• Interruptions During Application Deployment
• Exceptions During Application Deployment
  • OC4J Out-of-Memory Errors
  • Java Compiler Out-of-Memory Errors
  • Stack Overflow Errors
  • Errors for Number of Open Files

A Third Party Licenses

• ANTLR
  • The ANTLR License
• Apache
  • The Apache Software License
• Apache SOAP
  • Apache SOAP License
• DBI Module
  • Perl Artistic License
    • Preamble
    • Definitions
• FastCGI
  • FastCGI Developer's Kit License
  • Module mod_fastcgi License
• Info-ZIP Unzip Package
  • The Info-ZIP Unzip Package License
• JSR 110
• Jaxen
  • The Jaxen License
• JGroups
  • The GNU License
• mod_mm and mod_ssl
• OpenSSL
  • OpenSSL License
• Perl
  • Perl Kit Readme
  • mod_perl 1.29 License
  • mod_perl 1.99_16 License
  • Perl Artistic License
    • Preamble
    • Definitions
• SAXPath
  • The SAXPath License
• W3C DOM
  • The W3C License

Index