Skip to main content
Version: 8.2607.x.x LTS

Migration guide from LTS-2024 to LTS-2026

nevisAdapt - nevisDetect separation​

nevisAdapt and nevisDetect are no longer bundled together, they may have separate version numbers and release dates

  • nevisAdapt client libraries have their own new RPM package: nevisadaptcl
  • nevisAdapt backend libraries remain in the nevisadapt RPM package
  • nevisAdapt Java classes were moved to the new ch.nevis.nevisadapt package
  • nevisDetect libraries remain in nevisdetect and nevisdetectcl
  • nevisDetect Java classes remain in the ch.nevis.nevisdetect package
  • nevisadapt.properties template file is no longer included in the nevisDetect
  • nevisdetect-authstate no longer depends on nevisadapt-api
  • The detect auth state module is now called nevisDetect AuthStates instead of nevisRDF AuthStates

nevisDetect​

  • Major and minor versioning scheme changed: 7.2605.x.x to 8.2607.x.x
  • Required Java version increased to 25
  • Jackson library updated to v3. Please verify that the correct jackson group IDs are used:
    • com.fasterxml.jackson.core:jackson-databind -> tools.jackson.core:jackson-databind
    • com.fasterxml.jackson.dataformat:jackson-dataformat-properties -> tools.jackson.dataformat:jackson-dataformat-properties
    • com.fasterxml.jackson.dataformat:jackson-datatype-jdk8 -> merged into tools.jackson.core:databind module
    • com.fasterxml.jackson.dataformat:jackson-datatype-jsr310 -> merged into tools.jackson.core:databind module
    • please note that jackson-annotations group ID remains unchanged: com.fasterxml.jackson.core:jackson-annotations
  • Add a new JVM argument -Dnet.bytebuddy.experimental=true to all env.conf files. This is needed due to the Spring Boot 4.x / Hibernate upgrade.
    • /var/opt/nevisdetect/admin/conf/env.conf
    • /var/opt/nevisdetect/core/conf/env.conf
    • /var/opt/nevisdetect/entrypoint/conf/env.conf
    • /var/opt/nevisdetect/persistency/conf/env.conf
    • /var/opt/nevisdetect/mq/conf/env.conf
  • The logback.xml configuration files for all components have been updated to use lowercase XML element names
    • Pattern -> pattern
    • MinIndex -> minIndex
    • MaxIndex -> maxIndex
    • FileNamePattern -> fileNamePattern

The following changes must be applied to nevisdetect-*.properties when upgrading from 8.2511.x to 9.2605.0.

  • Renamed Spring Properties
    • spring.resources.add-mappings -> spring.web.resources.add-mappings
    • spring.http.encoding.charset -> server.servlet.encoding.charset
    • spring.http.encoding.enabled -> server.servlet.encoding.enabled
    • spring.http.encoding.force -> server.servlet.encoding.force
  • Renamed Hibernate Properties
    • hibernate.jdbc.batch_size -> spring.jpa.properties.hibernate.jdbc.batch_size
    • hibernate.order_inserts -> spring.jpa.properties.hibernate.order_inserts
    • hibernate.order_updates -> spring.jpa.properties.hibernate.order_updates
  • Removed / Deprecated Properties
    • spring.jpa.hibernate.use-new-id-generator-mappings=true is no longer required, the new ID generator mappings are used by default.
    • endpoints.enabled / endpoints.health.enabled / endpoints.health.sensitive — removed in Spring Boot 3+; use management.endpoints.* instead.
    • (persistency.properties) spring.jackson.serialization.write-dates-as-timestamps removed in Jackson 3.x
  • JMS Health Indicator
    • management.health.jms.enabled default value changed from true to false. Set management.health.jms.enabled=true explicitly in your configuration if you want to enable the JMS Health Indicator.
  • JVM Flags
    • -XX:+UseG1GC is recommended to revert Garbage Collector to G1 if ZGC (Java 25 default) causes performance issues.
    • -Dnet.bytebuddy.experimental=true was added as fallback option for potential ByteBuddy issues with the new JDK version.
  • Spring Security XMLs
    • Custom configurations must replace all occurrences of <global-method-security> with <method-security>.