Contents

About This Guide

Product Line Overview

Platform Edition
Standard Edition
Enterprise Edition

Using the Documentation
Documentation Conventions

General Conventions
Conventions Referring to Directories

Product Support
How This Guide Is Organized

Introduction to J2EE Connector Architecture

J2EE CA Overview

Assembling and Deploying the Connector

Overview of Assembly and Deployment

Modules
J2EE Standard Descriptors
Sun ONE Application Server Descriptors
Naming Standards
Runtime Environments
Classloaders
Sample Applications
Assembling a J2EE CA Resource Adapter

Deploying Modules and Applications

Deployment IDs and Errors
The Deployment Life Cycle

Dynamic Deployment
Disabling a Resource Adapter
Dynamic Reloading

Deploying a J2EE CA Resource Adapter

asadmin deploy
The Administration Interface

Access to Shared Frameworks

Security Management

Principal Mapping
Configured Identity

The Connector Deployment Descriptor Files

The sun-connector_1_0-0.dtd

Subelements
Data
Attributes

Elements in the sun-ra.xml File
Sample Application XML FIles

Sample sun-ra.xml File
Sample ra.xml File

Preparing the .rar File for Deployment

Directory Structure for the .rar File

Administering the Resource Adapter

Overview
Administrative Tasks

Creating Multiple Instances of a Resource Adapter
Security Configuration

Numerous users
Limited Number of Users

The Sample Connector and its Use in the Sample Application

Overview About Using the Comet Sample Application
Compiling and Assembling the Sample Application
The Sample Connector

Description of Sample Connector (comet.rar)

META-INF/ra.xml
comet.jar
META-INF/sun-ra.xml

Deploying the Sample Connector

The Sample Application

Directory Structure of the Sample Application
Deploying the Sample Application
How to Operate the Sample

Troubleshooting

Glossary