IBM Support

Jakarta EE support

General Page

As part of the initiative to add Jakarta EE support to the product, the Eclipse Transformer project from the Eclipse Foundation is used. Eclipse Transformer helps migrate Java EE–based artifacts to Jakarta EE by updating package names, namespaces, and related deployment descriptors.

Eclipse Transformer is an open-source utility maintained by the Eclipse community. Although the tool itself is not developed or maintained by us, it enables a smoother transition path for customers adopting Jakarta EE as part of their application modernization efforts.

Prerequisites

Download the following JAR files and place them in a single folder:

Procedure

  1. Create a HATS project using a Java EE–based runtime.

  2. Export the project as an EAR file.

  3. Place the exported EAR file in the same folder that contains the Eclipse Transformer JAR files.

  4. Open a command prompt in the folder containing both the JAR files and the EAR file and run the following command to perform the transformation:

    Syntax

    java -cp "org.eclipse.transformer.cli-1.0.0.jar;*"

    org.eclipse.transformer.cli.JakartaTransformerCLI <Input-file> <Output-file> -ti ts *.mf !

    Example:

    java -cp "org.eclipse.transformer.cli-1.0.0.jar;*"

    org.eclipse.transformer.cli.JakartaTransformerCLI Original.ear Transformed.ear -ti ts *.mf !

    Parameter Description

    • Original.ear 

      The EAR file exported from the HATS project that contains Java EE–based artifacts.

    • Transformed.ear

      The output EAR file generated by Eclipse Transformer. This file contains Jakarta EE–compatible artifacts converted from the original EAR file.

  5. The transformation tool processes the input EAR file.

  6. A converted EAR file is generated in the same folder as the input file.

  7. Deploy the transformed EAR file (Transformed.ear) to a Jakarta EE–supported application server.

Reference link: https://projects.eclipse.org/projects/technology.transformer

[{"Type":"MASTER","Line of Business":{"code":"LOB70","label":"Z TPS"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSXKAY","label":"IBM Host Access Transformation Services"},"ARM Category":[{"code":"a8m0z0000000CBgAAM","label":"HATS"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.0.0"}]

Document Information

Modified date:
18 March 2026

UID

ibm17258322

Page Feedback