GlassFish - World's first Java EE 7 Application Server


Enterprise JavaBeans Documentation Plan for GlassFish Server Open Source Edition 3.1

People and Roles

Name Role Location Time Zone Email
Rebecca Parks Documentation Feature Owner Santa Clara, CA, USA US/Pacific junesm@dev.java.net
  Additional Writer     java.netID@dev.java.net
  Peer Reviewer     java.netID@dev.java.net
Marina Vatkina Software Engineer Santa Clara, CA, USA US/Pacific java.netID@dev.java.net
Mahesh Kannan Software Engineer Santa Clara, CA, USA US/Pacific java.netID@dev.java.net
Cheng Fang Software Engineer Burlington, MA, USA US/Eastern java.netID@dev.java.net
Ming Zhang QA Engineer Santa Clara, CA, USA US/Pacific java.netID@dev.java.net

Audience

EJB components are primarily created and used by developers.

Summary of the Feature From a User's Perspective

Enterprise JavaBeans features for GlassFish Server Open Source Edition 3.1:

  • SFSB Checkpointing (parity with v2)
  • EJB Timer Clustering / Failover (parity with v2)
  • Full EJB 3.1 feature support in Embeddable EJB API (new)
  • Retain SFSB / EJB Timer state across redeployment (new)
  • User-specified thread pools for EJB timer and async callbacks (dropped)
  • Option to disable v2 vendor-specific JNDI names (new)

Availability

EJB 3.1 Lite features are available in the Web Profile distribution of GlassFish Server. Other EJB features are available only in the Full Platform distribution of GlassFish Server.

Statement of Work

This section describes in detail for each document the work that is required by the introduction of the feature, such as changes, addition of new material, relocation of existing material, and removal of existing material.

Documentation Impact:

  • None
  • Minor
  • Moderate
  • Major
  • New

Note - If a document is task based (as opposed to reference), the changes should be determined from the user task analysis for the feature.

Changes to Books

Administration Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
20 Administering the Java Naming and Directory Interface (JNDI) Service Moderate Rebecca Parks Cheng Fang Disabling v2 vendor-specific JNDI names in the server.

High Availability Administration Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
Stateful Session Bean Failover Moderate Rebecca Parks Mahesh Kannan Reinstate clustering and add state saving across redeployment.
6 Setting Up Clusters in GlassFish Server Moderate Rebecca Parks Marina Vatkina Explain how to use the asadmin utility to migrate EJB timers.

Application Development Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
EJB Timer Service Moderate Rebecca Parks Marina Vatkina Reinstate clustering. Add state saving across redeployment.
Stateful Session Bean Failover Moderate Rebecca Parks Mahesh Kannan Reinstate clustering. Add state saving across redeployment.
16 Using the Java Naming and Directory Interface Moderate Rebecca Parks Cheng Fang Disabling v2 vendor-specific JNDI names for an EJB component.

Application Deployment Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
EJB Module Deployment Guidelines Moderate Rebecca Parks Marina Vatkina Reinstate v2 feature summaries and add brief summaries of all new features described in the above Summary , especially SFSB/timer state saving across redeployment.
B Deployment Descriptors Minor Rebecca Parks Marina Vatkina Modify deployment descriptor element hierarchies to match element changes in Appendix C.
C Elements of Deployment Descriptors Moderate Rebecca Parks Marina Vatkina
Cheng Fang 		New <keep-state> element for SFSB/timer state saving across redeployment. New <disable-nonportable-jndi-names> element for disabling v2 vendor-specific JNDI names for an EJB component.

Embedded Server Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
Using the EJB 3.1 Embeddable API with Embedded GlassFish Server Minor Rebecca Parks Marina Vatkina Siraj Ghaffar List the newly supported EJB 3.1 features: message-driven beans, web service endpoints, remote EJB components with non-default IIOP ports, libraries, and the timer service.

Changes to Online Help

Administration Console Clustering Online Help Changes

See the Administration Console Documentation Plan.

Changes to Man Pages

Man Page Name and Section Documentation Impact Writer Reviewers Description of Change
redeploy Minor Rebecca Parks Marina Vatkina New --keep-state option (spelling uncertain) applies to SFSB/timer state saving.
migrate-timers Minor Rebecca Parks Marina Vatkina Reinstate entire man page, including --target option.*
list-timers Minor Rebecca Parks Marina Vatkina Reinstate target operand.*

*Originally named --destination or destination

Review Schedule

The review schedule for the documentation items that are affected by this feature is provided in the following table.

Item Review Start Date Review End Date
Administration Guide    
High Availability Administration Guide    
Application Development Guide    
Application Deployment Guide    
Embedded Server Guide    
EJB Timer Migration Online Help    
EJB-related asadmin subcommands    

Reviewers are listed in the Statement of Work.

Related Information

Email aliases: