Upgrade instructions versions 2.x versions

2.0.0

This version contains an upgrade to Spring Boot version 2 and Flyway version 5.

Database

The minimal database versions have changed:

  • Oracle 12.2
  • SQL Server 2014

Older versions of Oracle and SQL Server are no longer supported. The minimal version for MySQL (5.6) remains the same.

Environment variables

Environment variables with a new prefix:

Old variable name starts with New variable name starts with
FLYWAY_ SPRING_FLYWAY_
SECURITY_ SPRING_SECURITY_

Change the following environment variables:

Old variable name New variable name
ENDPOINTS_ENABLED MANAGEMENT_​ENDPOINTS_​ENABLED_​BY_​DEFAULT
ENDPOINTS_​HEALTH_​ENABLED MANAGEMENT_ENDPOINT_HEALTH_ENABLED
EXTENSION_​ENGINE_​BASIC_​AUTHENTICATION_​USER SPRING_SECURITY_USER_NAME
EXTENSION_​ENGINE_​BASIC_​AUTHENTICATION_​PASSWORD SPRING_SECURITY_USER_PASSWORD
EXTENSION_​ENGINE_​REDIS_​PASSWORD SPRING_REDIS_PASSWORD
EXTENSION_​ENGINE_​REDIS_​SENTINEL_​MASTER_​ID SPRING_REDIS_SENTINEL_MASTER
EXTENSION_​ENGINE_​REDIS_​SENTINEL_​NODES SPRING_REDIS_SENTINEL_NODES

The following environment variables all drop the EXTENSION_ENGINE prefix:

Old variable name New variable name
EXTENSION_​ENGINE_​DATABASE_​TYPE DATABASE_TYPE
EXTENSION_​ENGINE_​DATABASE_​URL DATABASE_URL
EXTENSION_​ENGINE_​DATABASE_​USERNAME DATABASE_USERNAME
EXTENSION_​ENGINE_​DATABASE_​PASSWORD DATABASE_PASSWORD
EXTENSION_​ENGINE_​DATABASE_​ENCRYPTION_​PASSWORD DATABASE_ENCRYPTION_PASSWORD
EXTENSION_​ENGINE_​DATABASE_​ENCRYPTION_​POOLSIZE DATABASE_ENCRYPTION_POOLSIZE
EXTENSION_​ENGINE_​DATABASE_​MIGRATIONS_​ENABLED DATABASE_MIGRATIONS_ENABLED
EXTENSION_​ENGINE_​PROPERTY_​ENCRYPTION_​PASSWORD PROPERTY_ENCRYPTION_PASSWORD
EXTENSION_​ENGINE_​REDIS_​DEFAULT_​TTL_​SECONDS REDIS_DEFAULT_TTL_SECONDS
EXTENSION_​ENGINE_​REST_​SERVICES_​READ_​TIMEOUT_​MILLIS REST_SERVICES_READ_TIMEOUT_MILLIS
EXTENSION_​ENGINE_​REST_​SERVICES_​CONNECT_​TIMEOUT_​MILLIS REST_SERVICES_CONNECT_TIMEOUT_MILLIS
EXTENSION_​ENGINE_​SECURITY_​CLASSES_​ALLOWED_​TO_​USE SECURITY_CLASSES_ALLOWED_TO_USE

Remove the following environment variables:

  • SPRING_DATASOURCE_MAX_WAIT
  • SPRING_DATASOURCE_MAX_ACTIVE
  • SPRING_DATASOURCE_MAX_IDLE
  • SPRING_DATASOURCE_TEST_ON_BORROW
  • SPRING_DATASOURCE_VALIDATION_QUERY