Upgrade instructions 10.x

10.0.0-M1

Run all database scripts

  • V9_01_00_02__add_additional_audiences_client_config.sql
  • V10_00_00_00__add_encryption_cols_for_open_id_config
  • V10_00_00_01__add_api_application_version_scope.sql
  • V10_00_00_02__add_access_token_format_to_client_config.sql

Changes in API

From this version, the Web Clients API requires access via the Config API scope instead of the Admin API scope. Create an API Client that supports the Config API scope if you are using the Web Clients API.

The Admin API scope is still used for the API Clients API.

Database connection configuration

From this version the Token Server uses a different database connection pooling mechanism. Some variables were no longer needed while other custom variable names were removed.

Changed variable names

The following variables were renamed to align with other products of Onegini:

Old variable name New variable name
TOKEN_​SERVER_​COMMON_​DB_​TYPE DATABASE_TYPE
TOKEN_​SERVER_​COMMON_​DB_​ENCRYPTION_​PASSWORD DATABASE_ENCRYPTION_PASSWORD
TOKEN_​SERVER_​COMMON_​DB_​ENCRYPTION_​POOLSIZE DATABASE_ENCRYPTION_POOLSIZE

Changed to Spring Boot defaults

The following variables were replaced by Spring Boot database variables:

Old variable name New variable name
TOKEN_​SERVER_​COMMON_​DB_​JDBC_​URL SPRING_DATASOURCE_URL
TOKEN_​SERVER_​COMMON_​DB_​USER SPRING_DATASOURCE_USERNAME
TOKEN_​SERVER_​COMMON_​DB_​PASSWORD SPRING_DATASOURCE_PASSWORD
TOKEN_​SERVER_​COMMON_​DB_​DRIVER_​CLASS SPRING_DATASOURCE_DRIVER_CLASS_NAME
TOKEN_​SERVER_​COMMON_​DB_​PLATFORM SPRING_JPA_PROPERTIES_HIBERNATE_DIALECT

Changed to Flyway defaults

The following variables were replaced by Flyway environment variables:

Old variable name New variable name
TOKEN_​SERVER_​COMMON_​DB_​MIGRATION_​ENABLED FLYWAY_ENABLED
TOKEN_​SERVER_​COMMON_​DB_​MIGRATION_​INIT_​VERSION FLYWAY_BASELINE_VERSION
TOKEN_​SERVER_​COMMON_​DB_​MIGRATION_​OUT_​OF_​ORDER FLYWAY_OUT_OF_ORDER
TOKEN_​SERVER_​COMMON_​DB_​MIGRATION_​FOLDER FLYWAY_LOCATIONS

Removed variables

The following variables are no longer used to configure the database connection and should be removed:

  • TOKEN_SERVER_COMMON_DB_CONNECTIONS_INITIAL_SIZE
  • TOKEN_SERVER_COMMON_DB_CONNECTIONS_MAX_ACTIVE
  • TOKEN_SERVER_COMMON_DB_CONNECTIONS_MAX_IDLE
  • TOKEN_SERVER_COMMON_DB_CONNECTIONS_MAX_WAIT
  • TOKEN_SERVER_COMMON_DB_CONNECTIONS_MAX_LIFETIME_MILLIS
  • TOKEN_SERVER_COMMON_DB_VALIDATION_QUERY
  • TOKEN_SERVER_COMMON_DB_SHOW_SQL