Installable enterprise module versions

The contents of a Java™ Platform, Enterprise Edition (Java EE) module affect whether you can install the module on a deployment target. A deployment target is a server or a cluster with at least one member on a WebSphere® Application Server product.

Installable application modules

Select only appropriate deployment targets for a module. You must install an application, enterprise bean (EJB) module, Session Initiation Protocol (SIP) module (SAR), or Web module on a Version 7.x target under any of the following conditions:

If a module supports Java 2 Platform, Enterprise Edition (J2EE) 1.4, then you must install the module on a Version 6.x or 7.x deployment target. Modules that call a 6.1.x API or use a 6.1.x feature can be installed on a 6.1.x or 7.x deployment target. Modules that call a 6.0.x API or use a 6.0.x feature can be installed on a 6.0.x, 6.1.x or 7.x deployment target. Modules that require 6.1.x feature pack functionality can be installed on a 7.x deployment target or on a 6.1.x deployment target that has been enabled with that feature pack.

Selecting options such as Precompile JavaServer Pages files, Use binary configuration, Deploy Web services or Deploy enterprise beans during application installation indicates that the application uses 6.1.x product features. You cannot deploy such applications on a 5.x or 6.0.x deployment target. You must deploy such applications on a 6.1.x or 7.x deployment target.

You can install an application or module developed for a Version 5.x product on a 5.x, 6.x or 7.x deployment target.

Avoid trouble: You must package container-managed persistence (CMP) or bean-managed persistence (BMP) entity beans in an EJB 2.1 or earlier module. You cannot install an EJB 3.0 module that contains CMP or BMP entity beans. Installation fails when a CMP or BMP entity bean is packaged in an EJB 3.0 module. You can install EJB 2.1 or earlier modules on a 5.x, 6.x or 7.x deployment target.gotcha

Installable RAR files

You can install a standalone resource adapter (connector) module, or RAR file, developed for a Version 5.x product to a 5.x, 6.x or 7.x deployment target, provided the module does not call any 6.x or 7.x runtime APIs. If the module calls a 6.x API, then you must install the module on a 6.x or 7.x deployment target. If the module calls a 7.x API, then you must install the module on a 7.x deployment target.

targets

A 5.x deployment target is a server or a cluster with at least one member on a WebSphere Application Server Version 5 product.

A 6.x deployment target is a server or cluster with all members on a WebSphere Application Server Version 6 product.

A 7.x deployment target is a server or cluster with all members on a WebSphere Application Server Version 7 product.

Table 1. Compatible deployment target versions for 5.x, 6.x and 7.x modules. Deploy modules to compatible deployment target versions.
Module type Module Java support Module calls 6.x or 7.x runtime APIs or uses 6.x or 7.x features? Client versions that can install module Deployment target versions
Application, EJB, or Web J2EE 1.3 No 5.x, 6.x or 7.x 5.x, 6.x or 7.x
Application, EJB, or Web J2EE 1.3 Yes 6.x for 6.x or 7.x APIs or features

7.x for 7.x APIs or features

6.x or 7.x

You must install modules that call 6.1.x runtime APIs or use 6.1.x features on a 6.1.x or 7.x deployment target. You can install modules that call 6.0.x runtime APIs or use 6.0.x features on any 6.x or 7.x deployment target.

Application, EJB, SAR, or Web J2EE 1.4 Yes or No 6.x or 7.x 6.x or 7.x
Application, EJB, SAR, or Web Java EE 5 Yes or No 7.x 7.x
Resource adapter JCA 1.0 No 5.x, 6.x or 7.x 5.x, 6.x or 7.x
Resource adapter JCA 1.0 Yes 6.x or 7.x 6.x or 7.x

You must install modules that call 6.1.x runtime APIs on a 6.1.x or 7.x deployment target. You can install modules that call 6.0.x runtime APIs on any 6.x or 7.x deployment target.

Resource adapter JCA 1.5 Yes or No 6.x or 7.x 6.x or 7.x

You must install modules that call 6.1.x runtime APIs on a 6.1.x or 7.x deployment target. You can install modules that call 6.0.x runtime APIs on any 6.x or 7.x deployment target.




Related concepts
Enterprise beans
Relational resource adapters and JCA
Web modules
Related tasks
Installing enterprise application files
Updating enterprise application files
Concept topic    

Terms of Use | Feedback

Last updated: Oct 20, 2010 7:53:43 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-dist&topic=crun_app_moduleversion
File name: crun_app_moduleversion.html