Migration Guide - intershop/iom-project-archetype GitHub Wiki

Migration / Feature Notes

This migration guide will outline all steps that have been completed to migrate iom-project-archetype between new IOM minor releases.

Important: The document is not intended to replace the general IOM migration guidelines or release notes. The target audience are users / projects that have used iom-project-archetype to bootstrap their projects and wish to keep that project structure up-to-date with our recommended structure.

2.5.0 to 2.6.0 / IOM 5.0.0

Improvements

  • The generated project now supports the creation of a site-report (mvn site, mvn site:stage ...)
  • Maven plugins were updated to current versions.
  • POM was restructured to separate plugin-management and configuration from each other.
  • Configuration of assembly-plugin was changed, for better handling of files belonging to custom mail-templates.

Dependencies

  • Wildfly upgrade to 30.0.1.Final
  • IOM Testframework upgrade to 7.1.0

See PR #22 https://github.com/intershop/iom-project-archetype/pull/22/files

Other

See PR #25 https://github.com/intershop/iom-project-archetype/pull/25/files

2.4.0 to 2.5.0 / IOM 4.7.3

Improvements

2.3.0 to 2.4.0 / IOM 4.5.0

Improvements

2.2.0 to 2.3.0 / IOM 4.4.0

Only code migrations have been performed - please follow the general Migration Guide for IOM 4.4.0.

2.1.0 to 2.2.0 / IOM 4.2.1, Support for Testframework and Partner DevOps

See pull requests in milestone 2.2.0

Improvements

  • Added support for Testframework:
    • User-specific configuration file of Testframework was added to .gitignore
    • Added dependencies for Testframework
    • Added integration tests to Maven verify goal
  • Added support for Azure Partner DevOps Environment:
    • Added azure-pipelines.yml for CI automation
    • Renamed maven repository to iom-maven-artifacts to match the standard naming in Azure Partner DevOps Environment
    • Renamed Intershop Docker Repository to docker.tools.intershop.com/iom/intershophub/ to match the standard naming in Azure Partner DevOps environment
    • Adapted CI pipeline to match the changed repositories
  • Adapted to changes of IOM
    • Removed obsolete properties is.oms.mail.internal.* from cluster.properties
    • Updated platform version to 4.1.3
  • Simplified handling of expanded enums, cleanup of Expanded***DefDO classes (removed JPA annotations)

Dependencies

  • Wildfly upgrade to 26.1.2.Final

Other

  • Some example functions from the DBMigrate directory have been removed - from now on please refer to the iom-blueprint-project

2.0.0 to 2.1.0 / IOM 4.0 to 4.1

See PR #9 https://github.com/intershop/iom-project-archetype/pull/9/files

Improvements

Only relevant for the archetype / new projects

  • The "DOT" placeholder parameter has been removed / replaced by a hardcoded parameter
  • Added additional default parameter values to make use of "askForDefaultPropertyValues" in the most recent maven archetype plugin

Bugfixes

  • project.cluster.properties: the default log level of custom loggers has been changed from "ALL" to the configurable envioronment variable $OMS_LOGLEVEL_CUSTOMIZATION, i.e. the log level of the "CUSTOMIZATION" log appender.

Dependencies

  • Wildfly upgrade to 26.1.0.Final
  • Use latest maven-compiler-plugin (due to unexpected / unexplained compilation errors)

1.0.1 to 2.0.0 / IOM 3.7 to 4.0

See PR #5 https://github.com/intershop/iom-project-archetype/pull/5/files

Bugfixes

  • A typo in the assembly descriptor prevented images / pdf includes from being included in the assembly / images. Fixed in commit afbeeb0
  • Added devenv.user.properties to .gitignore file by default

Dependencies

  • Wildfly upgrade to 26.0.1.Final
  • Switch from caas2docker to project2docker

Build process

Due to the switch from two images ("iom-app", "iom-config") to a single image ("iom") the "docker" build profile had to be adjusted. Multiple properties and environment variables were renamed to be compatible with the new build process. Please check the required changes in the linked pull request.

1.0.0 to 1.0.1 / IOM 3.6 to 3.7

See PR #4 https://github.com/intershop/iom-project-archetype/pull/4/files

Dependencies

  • Wildfly upgrade to 25.0.1.Final
  • There was a package split of resteasy-jaxrs - see https://issues.redhat.com/browse/WFLY-14812
  • Upgraded reflections to 0.10.2 (see PR - code changes necessary in example classes)
  • Implicit dependency to guava has been removed - side effect of the reflections upgrade (see PR - code changes necessary in example classes)