Skip to content

Upgrade instructions 1.x

1.8.0

New parameter needed for MySQL JDBC connection String

We had to bump MariaDB JDBC driver, which now requires a new parameter permitMysqlScheme when the JDBC connection URL string is prefixed with jdbc:mysql:. Please, therefore, add it at the end of the JDBC connection URL, for example:

jdbc:mysql://DB-HOST:3306/custome-ins?autoReconnect=true&useMysqlMetadata=true&permitMysqlScheme

For the JDBC connection URL Strings prefixed with jdbc:mariadb: nothing has to be changed.

No aurora: failover parameter allowed for MySQL JDBC connection String anymore

For the same reason (MariaDB JDBC driver upgrade) the failover parameter value aurora: is no longer supported. We need to remove it and rely on the default Aurora setting.

Before: 

jdbc:mysql:aurora://DB-HOST:3306/custome-ins?autoReconnect=true&useMysqlMetadata=true&permitMysqlScheme

After: 

jdbc:mysql://DB-HOST:3306/custome-ins?autoReconnect=true&useMysqlMetadata=true&permitMysqlScheme

For more information and supported failover parameter values, please refer to 📘 the MariaDB documentation.

1.6.1

  • The configuration properties mentioned under 1.6.0 are no longer mandatory.

1.6.0

  • This release requires the following configuration properties to be set, N.B.: also when JWT authentication is not used:
    • SPRING_SECURITY_OAUTH2_RESOURCESERVER_JWT_ISSUER_URI -> This must be set to a proper URI that points to a running OIDC provider.
    • SECURITY_OAUTH2_JWT_AUDIENCE
    • SECURITY_OAUTH2_JWT_SCOPE

1.4.0

  • Basic authentication configuration properties names have changed. Following property names must be changed:

    • SECURITY_USER_NAME -> SPRING_SECURITY_USER_NAME
    • SECURITY_USER_PASSWORD -> SPRING_SECURITY_USER_NAME

  • healthcheck endpoint uri has changed, for details please see setup

1.1.0

  • We returned to default database configuration properties, following property names must be changed:

    • DATABASE_USERNAME -> SPRING_DATASOURCE_USERNAME
    • DATABASE_PASSWORD -> SPRING_DATASOURCE_PASSWORD
    • DATABASE_URL -> SPRING_DATASOURCE_URL
    • DATABASE_DRIVER_CLASS_NAME -> SPRING_DATASOURCE_DRIVER_CLASS_NAME

  • Insights on first startup removes data for following graphs:

  • Data for those graphs will not be available until next data generation task completes. It is also recommended to upgrade source components first, before upgrading Insights.