When updating your yuuvis® Momentum installation to version 2022 Spring, manual configuration changes are required for some services.
Table of Contents
Breaking Changes
The following Breaking Changes are incompatible changes we had to deploy into operation, and therefore you—as a yuuvis® user—need to be aware of them and take action accordingly.
Core
Performance Optimization for CONFIGSERVICE
Local and remote resources on the git server are synchronized now at regular intervals of 5 minutes. Thus, changes applied directly to the remote resources on the git server are NOT available until the regular synchronization process is passed. The resources are always cached. The availability of the git server is not checked anymore in case of resource retrieval requests. It is not possible to set the parameter fail-if-git-not-available=true
anymore.
Furthermore, the Helm Charts for 2022 Spring require a persistent volume claim for service initialization after a crash of the CONFIGSERVICE.
Client Services & Client Development
Developer Libraries
Object Creation Permissions
The permission to create new objects is now enabled via a create permission within one of the roles defined via a role set. The YUUVIS_CREATE_OBJECT role does no longer allow object creation. You need to adjust your corresponding role set accordingly.
Action: Update your roles as described here. Use the following condition:
<condition>system:objectTypeId = 'appClient:minidoc' AND system.secondaryjectTypeIds = 'appClient:minidoc'</condition>
USERSERVICE
Migration of User Information Endpoints.
The user information endpoints GET /userservice/api/users and GET /userservice/api/users/{userId} are not available anymore.
Action: Use the endpoints GET /api-web/api/users/users and GET /api-web/api/users/{userId} instead.
Configurations Enabling new Features
Some new features require manual configuration in order to operate properly after the update to the new yuuvis® Momentum version.
Core
Fail-safe AUTHENTICATION Service
In order to enable the shared usage of the session state for multiple instances of the AUTHENTICATION service, the session state has to be stored in a Redis database. In the default configuration of yuuvis® Momentum, the session state is stored by the individual AUTHENTICATION service instances. Thus, in order to enable the central storage of the session state in Redis, manual configuration steps are required.
Extend the authentication-prod.yml configuration file by the following lines:
spring.session.store-type: redis management.health.redis.enabled: true
- Add the
redis
profile to the AUTHENTICATION service:Run the command:
kubectl -n yuuvis edit deploy authentication
- Extend the
SPRING_PROFILES_ACTIVE
environment variable withredis
.
- Restart all instances of the AUTHENTICATION service.
For example, instance 2 can be restarted using the following command:
kubectl -n yuuvis scale deploy authentication --replicas=2