You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
Before you upgrade make sure to read the General Upgrade instructions as well as the Upgrade instructions for previous versions.
The changes are color coded. Orange elements have been changed, Green elements have been added and Red elements have been removed compared to the 17.8 release.
Table of contents
Assign admin role to studio-server client in Keycloak
Since 17.9, the "studio-server" client (the Keycloak client which the Studio backend uses for internal communications) must have an admin role assigned to it.
For new installations this role is assigned automatically during installation.
When upgrading from 17.8 or earlier to 17.9 however, this admin role must be assigned manually to the studio-server. If the default Keycloak roles are still used, this can be the "studio-admin" role. If you have a custom Keycloak configuration, you must identify a Keycloak role which has administrator permissions (via the role mapping) in the Studio.
For the following steps, we will assume this is the "studio-admin" role:
- Log in to Keycloak (via User Management) and select the BlueriqStudio17 realm
- In the navigation menu on the left, select "Clients"
- In the client list, select "studio-server"
- Fromt he available tabs, select "Service account roles"
- Click the "Assign role" button
- Select the "studio-admin" role
- Click the "Assign" button
Metamodel generator
In 17.9, two parameters have been renamed in order to improve consistency
- userName has been renamed to username
- passWord has been renamed to password
In addition, the BASIC authentication type has been deprecated (but still available) and two new OIDC authentication types OID_CLIENT_CREDENTIALS and OIDC_PASSWORD have been added to replace BASIC.
It is recommended to migrate away from BASIC as soon as possible.
View the full parameters list on the Maven Metamodel Generator page.
Known issues
For an overview of known issue please refer to: Known issues.