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) archive (SAR), web module, or client module on a Version 9.x target under any of the following conditions:

  • The module supports a Java Platform, Enterprise Edition (Java EE) 7 technology added in 9.x.
  • The module calls a 9.x runtime application programming interface (API).
  • The module uses a 9.x product feature.

    For example, because support for using Java EE default bindings was added in Version 9.0, you must install a module that uses Java EE default bindings only to a Version 9.x target.

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

Selecting options such as Precompile JavaServer Pages files, Deploy web services or Deploy enterprise beans during application installation indicates that the application uses features of the current product version. Do not select these options if the targets of the applications are on older version nodes. Use the tools available in the older version, such as JspBatchCompiler, wsgen, or ejbdeploy, to update your application with generated code before deploying your application.

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.x module that contains CMP or BMP entity beans. Installation fails when a CMP or BMP entity bean is packaged in an EJB 3.x module. You can install EJB 2.1 or earlier modules on a 9.x, 8.x, or 7.x deployment target.

Installable RAR files

You can install a stand-alone resource adapter (connector) module, or RAR file, developed for a Version 7.x product to a 9.x, 8.x, or 7.x deployment target. You must install a module that calls an 8.x API on a 9.x or 8.x deployment target. You must install a module that calls a 9.x API on a 9.x deployment target.

Deployment targets

The following table lists the compatible deployment target versions for various modules. 9.x, 8.x, or 7.x for Deployment target versions indicates that you can deploy the module to a WebSphere Application Server Version 9, 8, or 7 server or cluster.

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

9.x or 8.x for 8.x APIs or features

9.x, 8.x, or 7.x
Application, EJB, SAR, or web J2EE 1.4 Yes or No 9.x, 8.x, or 7.x 9.x, 8.x, or 7.x
Application, EJB, SAR, or web Java EE 5 Yes or No 9.x, 8.x, or 7.x 9.x, 8.x, or 7.x
Application, EJB, SAR, or web Java EE 6 Yes or No 9.x. or 8.x 9.x or 8.x
Application, EJB, SAR, or web Java EE 7 Yes or No 9.x

9.x or 8.5.x for web modules

9.x

9.x or 8.5.x for web modules

Client Any Java EE version Yes or No 9.x or 8.x 9.x or 8.x
Resource adapter JCA 1.0 No 9.x, 8.x, or 7.x 9.x, 8.x, or 7.x
Resource adapter JCA 1.0 Yes 9.x, 8.x, or 7.x 9.x, 8.x, or 7.x
Resource adapter JCA 1.5 Yes or No 9.x, 8.x, or 7.x 9.x, 8.x, or 7.x
Resource adapter JCA 1.6 Yes or No 9.x or 8.x 9.x or 8.x
Resource adapter JCA 1.7 Yes or No 9.x 9.x