Upgrade overview and considerations

Spring compatibility

For PingDirectory Suite releases prior to 9.0.0.0, Spring configuration properties in the administrative console are not compatible with the most recent console bundled with 9.0.0.0 and later. This is due to major updates to Spring dependencies. Attempting to use these older configuration files will result in the console failing to start.

If you are using older administrative console configuration files, they should be updated. Replace the following excerpt in the old application.yml file:

spring:
  profiles.active: default
  main.show-banner: false
  thymeleaf.cache: true
  thymeleaf.prefix: classpath:/public/app/

with the following:

spring:
  profiles.active: default
  web.resources:
    # 1 year. Update the corresponding value in MvcConfig if this changes.
    cache.period: 31536000
    add-mappings: false # use our custom mappings instead of the defaults
  main:
    banner-mode: "OFF"
  thymeleaf:
    prefix: classpath:/public/app/