Jakarta EE 9.1 feature updates
The names and version numbers of some of the Open Liberty features that support the Jakarta EE platform are updated for the Jakarta EE 9.1 release. In some cases, you must change both the feature version and short name in your server configuration to update your server for Jakarta EE 9.1.
As part of the transition from Java EE to the open source Jakarta EE platform, the namespace of the underlying API packages changed from
jakarta. The Open Liberty features that support the Jakarta EE platform are also updated to reflect this change with the release of Open Liberty 22.214.171.124. For some Jakarta EE features, only the version number is changed. For others, both the feature version and short name are changed. If you are updating your server to Jakarta EE 9.1, you must specify the updated feature versions and short names in your
For example, the Contexts and Dependency Injection feature is updated from
cdi-3.0. To update this feature for Jakarta EE 9.1, you need to update only the version number. However, in some cases, the feature short name is also changed, as with the Enterprise JavaBeans 3.2 feature (
ejb-3.2), which was updated to Enterprise Beans 4.0 (
enterpriseBeans-4.0). To update this feature, you must specify both the new version number and the new short name.
In the following
server.xml file example, three Java EE features are specified.
To update this configuration to support Jakarta EE 9.1, you must specify the updated feature versions and short names. For the
servlet-4.0 feature, only the version number is changed. However, both the other features have updated version numbers and short names. The
jpa-2.2 feature becomes
persistence-3.0 and the
restfulWS-3.0. The following example shows the updated configuration for Jakarta EE 9.1.
For features with updated short names, if the old short name is specified with a Jakarta EE 9.1 version number, the server does not start. In such cases, the server logs provide information to indicate which new feature short name must be specified. For example, if
ejb-3.2 is incorrectly changed to
ejb-4.0, the server logs indicate that
enterpriseBeans-4.0 must be used.
Open Liberty provides several convenience features, which can enable a whole set of features all at once. For example, the Jakarta EE platform feature enables all features that support the Jakarta EE platform. If you update this feature from the previous short name and version number,
jakartaee-9.1, all of the Jakarta EE 9.1 features are automatically enabled. For more information, see Feature overview.
These tables list the Open Liberty features that are updated for Jakarta EE 9.1. Table 1 lists the features for which only the version number is changed. Table 2 lists the features for which both the version number and short name are changed.
The following table lists features for which only the feature version is changed. To update one of these features for Jakarta EE 9.1, you must change only the feature version number in your
|Java EE/Jakarta EE 8 feature name
|Jakarta EE 9.1 feature name
Application Client Support for Server
Contexts and Dependency Injection
Java EE Managed Bean
Java EE Web Profile
The following table lists the features for which both the short name and the version number are changed. To update one of these features for Jakarta EE 9.1, you must change both the feature short name and version number in your
|Jakarta EE 9.1 feature name
|Java EE/Jakarta EE 8 short name and version
|Jakarta EE 9.1 short name and version
Jakarta Enterprise Beans
Jakarta Enterprise Beans Home Interfaces
Jakarta Enterprise Beans Lite
Jakarta Enterprise Beans Persistent Timers
Jakarta Enterprise Beans Remote
Jakarta Expression Language
Jakarta EE Platform
Jakarta EE Application Client
Jakarta XML Binding
Jakarta RESTful Web Services
Jakarta RESTful Web Services Client
Jakarta XML Web Services
Jakarta Connectors Inbound Security
Jakarta Persistence Container
Jakarta Server Faces
Jakarta Server Faces Container
Jakarta Server Pages
Messaging Server Client
Messaging Server Security
The Eclipse Transformer can help with moving your applications from Java EE and its
javax namespace to Jakarta EE and its
jakarta namespace. This tool is an open source project that was originally developed by members of the Open Liberty team and then contributed to the Eclipse Foundation.