Red Hat Application Server
JOnAS User Guide
Copyright
© 1999-2005 by ObjectWeb Consortium
ISBN: N/A
Table of Contents
I.
Introductory JOnAS Documentation
1.
Java Open Application Server (JOnAS)
1.1.
Introduction to Red Hat Application Server
1.2.
JOnAS Features
1.3.
JOnAS Architecture
1.4.
JOnAS Development and Deployment Environment
1.5.
Clustering and Performance
1.6.
Future Development
2.
Getting Started with JOnAS
2.1.
Running the First EJB Application
2.2.
More Complex Examples
3.
JOnAS Configuration
3.1.
JOnAS Configuration Rules
3.2.
Configuring the JOnAS Environment
3.3.
Configuring the Communication Protocol and JNDI
3.4.
Configuring Logging System (monolog)
3.5.
Configuring JOnAS Services
3.6.
Configuring the DB Service (hsql)
3.7.
Configuring the Discovery Service
3.8.
Configuring JMS Resource Adapters
4.
Configuring JDBC DataSources
4.1.
Configuring DataSources
4.2.
CMP2.0/JORM
4.3.
JDBC Connection Pool Configuration
4.4.
Tracing SQL Requests Through P6Spy
5.
JOnAS Class Loader Hierarchy
5.1.
Understanding the Class Loader Hierarchy
5.2.
Commons Class Loader
5.3.
Application Class Loader
5.4.
Tools Class Loader
5.5.
Tomcat Class Loader
5.6.
JOnAS Class Loaders
5.7.
JOnAS Class Loader Hierarchy
6.
JOnAS Command Reference
6.1.
jonas
6.2.
jclient
6.3.
newbean
6.4.
registry
6.5.
GenIC
6.6.
JmsServer
6.7.
RAConfig
II.
Enterprise Beans Programmer's Guide
7.
Developing Session Beans
7.1.
Introduction to Session Beans
7.2.
The Home Interface
7.3.
The Component Interface
7.4.
The Enterprise Bean Class
7.5.
Tuning the Stateless-Session Bean Pool
8.
Developing Entity Beans
8.1.
Introduction to Entity Beans
8.2.
The Home Interface
8.3.
The Component Interface
8.4.
The Primary Key Class
8.5.
The Enterprise Bean Class
8.6.
Writing Database Access Operations (Bean-Managed Persistence)
8.7.
Configuring Database Access for Container-Managed Persistence
8.8.
Using CMP2.0 Persistence
8.9.
Standard CMP2.0 Aspects
8.10.
JOnAS EJBQL extension
8.11.
JOnAS Database Mappers
8.12.
JOnAS Database Mapping (Specific Deployment Descriptor)
8.13.
Tuning a Container for Entity Bean Optimizations
9.
Developing Message-Driven Beans
9.1.
Description of a Message-Driven Bean
9.2.
Developing a Message-Driven Bean
9.3.
Administration Aspects
9.4.
Running a Message-Driven Bean
9.5.
Transactional Aspects
9.6.
Message-Driven Beans Example
9.7.
Tuning the Message-Driven Bean Pool
10.
Defining the Deployment Descriptor
10.1.
Principles
10.2.
Example of Session Descriptors
10.3.
Example of Container-managed Persistence Entity Descriptors (CMP 1.1)
10.4.
Tips
11.
Transactional Behavior of EJB Applications
11.1.
Declarative Transaction Management
11.2.
Bean-managed Transactions
11.3.
Distributed Transaction Management
12.
Enterprise Bean Environment
12.1.
Introduction
12.2.
Environment Entries
12.3.
Resource References
12.4.
Resource Environment References
12.5.
EJB References
13.
Security Management
13.1.
Introduction
13.2.
Declarative Security Management
13.3.
Programmatic Security Management
14.
EJB Packaging
14.1.
Enterprise Bean Principles
15.
Application Deployment and Installation Guide
15.1.
Deployment and Installation Process Principles
15.2.
Example of Deploying and Installing an EJB Using an EJB-JAR File
15.3.
Deploying and Installing a Web Application
15.4.
Deploying and Installing a J2EE Application
III.
Web Application Programmer's Guide
16.
Developing Web Components
16.1.
Introduction to Web Component Development
16.2.
The JSP Pages
16.3.
The Servlets
16.4.
Accessing an EJB from a Servlet or JSP Page
17.
Defining the Web Deployment Descriptor
17.1.
Principles
17.2.
Examples of Web Deployment Descriptors
17.3.
Tips
18.
WAR Packaging
18.1.
Principles
IV.
J2EE Client Application Programmer's Guide
19.
Launching J2EE Client Applications
19.1.
Launching Clients
19.2.
Configuring the Client Container
19.3.
Examples
20.
Defining the Client Deployment Descriptor
20.1.
Principles
20.2.
Examples of Client Deployment Descriptors
20.3.
Tips
21.
Client Packaging
21.1.
Principles
V.
J2EE Application Assembler's Guide
22.
Defining the EAR Deployment Descriptor
22.1.
Principles
22.2.
Simple Example of Application Deployment Descriptor
22.3.
Advanced Example
22.4.
Tips
23.
EAR Packaging
23.1.
Principles
VI.
Advanced Topics
24.
JOnAS Services
24.1.
Introducing a New Service
24.2.
Advanced Understanding
25.
JOnAS and the Connector Architecture
25.1.
Introducing the Connector Architecture
25.2.
Defining the JOnAS Connector Deployment Descriptor
26.
JMS User's Guide
26.1.
JMS is Pre-installed and Configured
26.2.
Writing JMS Operations Within an Application Component
26.3.
Some Programming Rules and Restrictions When Using JMS within EJB
26.4.
JMS Administration
26.5.
Running an EJB Performing JMS Operations
26.6.
A JMS EJB Example
27.
Ant EJB Tasks: Using EJB-JAR
27.1.
ejbjar Parameters
27.2.
GenIC Ant Task
28.
Login Modules in a Java Client
28.1.
Configuring an Environment to Use Login Modules with Java Clients
28.2.
Example of a Client
29.
Web Services with JOnAS
29.1.
Web Services
29.2.
Exposing a J2EE Component as a Web Service
29.3.
The Web Services Client
29.4.
WsGen
29.5.
Limitations
VII.
How-to Documents
30.
JOnAS Migration
30.1.
JOnAS 4.3.x to JOnAS 4.4.1
30.2.
JOnAS 4.1 to JOnAS 4.3.x
30.3.
JOnAS 3.3.x to JOnAS 4.1
30.4.
JOnAS 3.1 to JOnAS 3.1.4
30.5.
JOnAS 3.0 to JOnAS 3.1
30.6.
JOnAS 2.6.4 to JOnAS 3.0
30.7.
JOnAS 2.6 to JOnAS 2.6.1
30.8.
JOnAS 2.5 to JOnAS 2.6
30.9.
JOnAS 2.4.4 to JOnAS 2.5
30.10.
JOnAS 2.4.3 to JOnAS 2.4.4
30.11.
JOnAS 2.3 to JOnAS 2.4
31.
Integrating Tomcat and JOnAS (for JOnAS version < JOnAS 2.6)
31.1.
Installing Tomcat
31.2.
Configuring Tomcat for JOnAS
31.3.
Structuring your Web Application
31.4.
Writing a servlet accessing a bean
31.5.
Writing a JSP accessing a bean
31.6.
Compiling your Web Application
31.7.
Running your Web Application
31.8.
Troubleshooting
32.
Integrating Tomcat and JOnAS
32.1.
Configuring Tomcat for JOnAS
32.2.
Structuring your Web Application
33.
Example for Using Security in JOnAS with Tomcat
33.1.
Example Description
33.2.
Setting Up the Example
33.3.
Some warnings...
33.4.
Do not forget...
34.
How to Install a jUDDI Server on JOnAS
34.1.
UDDI Server
34.2.
What is jUDDI?
34.3.
Where Can I Find the Latest Version?
34.4.
Installation Steps
34.5.
Links
35.
Howto: JSR 160 Support in JOnAS
35.1.
What is JSR 160?
35.2.
Connector servers created by JOnAS
36.
Using the MC4J JMX Console
36.1.
Connecting to the JMX server
37.
Working with Management Beans
37.1.
Target Audience and Rationale
37.2.
About JOnAS MBeans and their use in JonasAdmin
37.3.
Using JOnAS MBeans in a Management Application
37.4.
Registering User MBeans
38.
JOnAS and JMX: Registering and Manipulating MBeans
38.1.
ServletContextListener
38.2.
Configuration
38.3.
Library dependencies
38.4.
HibernateService Extension
39.
How to Use JOnAS through a Firewall
40.
How To Configure and Use xdoclet for JOnAS
40.1.
Downloading and installing xdoclet
40.2.
Ejbdoclet Ant target
40.3.
Xdoclet tags
41.
Domain Management in JOnAS
41.1.
Domain Management Goals
41.2.
Mechanisms Used by Domain Management
41.3.
How to Start Manageable Servers in a Domain
42.
Clustering with JOnAS
42.1.
Cluster Architecture
42.2.
Load Balancing at the Web Level with mod_jk or Enhydra Director
42.3.
Session Replication at the Web Level
42.4.
Load Balancing at the EJB Level
42.5.
Clustering databases with C-JDBC
42.6.
Preview of a Coming Version
42.7.
Used Symbols
42.8.
References
43.
Load Balancing with Enhydra Director
44.
Setting Up mod_jk with embedded Tomcat
45.
Setting Up mod_jk2 with Embedded Tomcat
46.
Migrating from mod_jk2 to mod_jk with embedded Tomcat
46.1.
Performing the Migration
47.
HowTo Set Up a C-JDBC Database
47.1.
Sample Configuration of a C-JDBC Database in JOnAS
48.
Distributed Message Beans in JOnAS 4.1
48.1.
Scenario and General Architecture
48.2.
Common Configuration
48.3.
Specific Configuration
48.4.
The Beans
49.
How to use Axis in JOnAS
49.1.
Unique Axis Webapp
49.2.
Embedded Axis Webapp
49.3.
Axis Tests
49.4.
Axis Tools
50.
Using WebSphere MQ JMS
50.1.
Architectural Rules
50.2.
Setting the JOnAS Environment
50.3.
Configuring WebSphere MQ
50.4.
Starting the Application
50.5.
Limitations
51.
Web Service Interoperability between JOnAS and BEA WebLogic
51.1.
Libraries
51.2.
Accessing a JOnAS Web Service from a WebLogic Server's EJB
51.3.
Accessing a WebLogic Web Service from a JOnAS EJB
52.
RMI-IIOP Interoperability between JOnAS and BEA WebLogic
52.1.
Accessing a JOnAS EJB from a WebLogic Server's EJB using RMI-IIOP
52.2.
Access a WebLogic Server's EJB from a JOnAS EJB using RMI-IIOP
53.
Interoperability between JOnAS and CORBA
53.1.
Accessing an EJB Deployed on a JOnAS Server by a CORBA Client
53.2.
Accessing a CORBA Service by an EJB Deployed on JOnAS Server
54.
How to Migrate the New World Cruises Application to JOnAS
54.1.
JOnAS Configuration
54.2.
SUN Web Service
54.3.
JOnAS Web Service
55.
Configuring JDBC Resource Adapters
55.1.
Configuring Resource Adapters
55.2.
Using CMP2.0/JORM
55.3.
ConnectionManager Configuration
55.4.
Tracing SQL Requests through P6Spy
55.5.
Migration from dbm Service to the JDBC RA
56.
Configuring Resource Adapters
56.1.
Principles
56.2.
Description and Examples
Index
Next
Introductory JOnAS Documentation