Migrating from 13.1 to 13.2
Upgrading to version 13.2 is supported only from an Axon Ivy Engine 10.0 or higher. If your Axon Ivy Engine is older than version 10.0, you must first migrate to a version between 10.0 and 12.0.
Final Eclipse-Based Axon Ivy PRO Designer
This is the final release of the PRO Designer based on the Eclipse IDE. Starting with LTS 14, the PRO Designer will transition to a VS Code extension. A Beta version is already available - try it out and share your feedback!
Axon Ivy Java API Maven Dependency
The version of the ivy-project-parent in the pom.xml file has been updated from 13.1 to 13.2.
For projects using ivy-project-parent, the following dependencies have been replaced:
unit-tester→ìvy-test-apiweb-tester→ìvy-web-test-api
What You Need to Do:
Run the project migration tool to automatically update your pom.xml file.
Execute your maven build and ensure everythings compiles and all tests pass successfully.
For more details about the Axon Ivy Java API and troubleshoot issues, refer to Troubleshoot Java Compilation Errors.
Persistence API (Hibernate)
The Persistence API has been migrated from Java Persistence API (JPA) 2.2 to Jakarta Persistence API 3.2. The implementation has been updated from Hibernate 5.6 to Hibernate 7.0.
Package names have changed:
javax.persistence→jakarta.persistencejavax.transaction→jakarta.transaction
What You Need to Do:
Run the project migration tool to automatically update your code.
Use File Search in the Designer to ensure all references are updated.
This marks the first step in the migration from Java EE to Jakarta EE. Further migrations will follow in future releases.
Mail API
The Mail API has been migrated from Java Mail API 1.6 to Jakarta Mail API 2.0.
Package names have changed:
javax.mail→jakarta.mailjavax.activation→jakarta.activation
What You Need to Do:
Run the project migration tool to automatically update your code.
Use File Search in the Designer to ensure all references are updated.
Recommendation:
Instead of using the Jakarta Mail API, consider:
The E-Mail Activity
The new Mail Public API.
This marks the first step in the migration from Java EE to Jakarta EE. Further migrations will follow in future releases.
HttpHeaderSecurityFilter and RemoteIpFilter in web.xml
You can now define the Reverse Proxy HTTP Headers and security response HTTP Headers in the ivy.yaml file. While it is still possible to configure these in web.xml, it is no longer recommended. If you continue to use web.xml, headers may appear twice.
What You Need to Do:
Remove the following configurations from web.xml and migrate them to ivy.yaml:
org.apache.catalina.filters.HttpHeaderSecurityFilter→WebServer.HttpHeadersorg.apache.catalina.filters.RemoteIpFilter→ReverseProxy.HttpHeaders
Schema header in ivy.yaml and app.yaml
If your ivy.yaml and app.yaml do not include a schema header, the Axon Ivy Engine will now assume that they are in the latest version. Auto-migration of these files will not happen anymore.
Recommendation:
Always version your configuration files by including a schema header.
Tag Legend:
This migration is handled by the Migration Wizard.
This migration will change something in the engine operation. If you are responsible for the operation of an engine, check if this change affects you.
This migration highlights behaviors or features that are deprecated. That functionality will be removed soon. If you are responsible for the operation of an engine, you should check if this change affects you.
This migration will remove a behavior or feature that has been available for the engine operation. If you are responsible for the operation of an engine, check if this change affects you.
This migration is handled by the Project Conversion automatically.
This migration will change a certain behavior in the projects. If you are a project developer, check if this change affects you.
This migration will mark features or APIs as deprecated in projects. That functionality will be removed soon. If you are a project developer, check if this change affects you.
This migration will remove a behavior or feature of a project. If you are a project developer, check if this change affects you.