Bloomreach

Bloomreach Documentation version

Developer Docs / Backend Development / Upgrade / Upgrade 17.1 to 17.2

Upgrade 17.1 to 17.2

Goal

Upgrade a Bloomreach Experience Manager implementation project from version 17.1.x to 17.2.y.

Significant Changes

This minor release introduces a technical stack upgrade for the AI Content Assistant and a consolidation of MIME type handling for uploads. The most significant updates for developers moving from 17.1 to 17.2 include:

  • Spring AI upgraded to 2.0.0: The Vertex AI Gemini chat model integration now uses Spring AI's newer Google GenAI module, since the previous module was removed upstream. Several AI-related configuration properties are renamed or removed as a result. See Upgrade Steps below for full details.

  • Targeting and Content Audiences UI modernized: The Targeting module's front end moved from AngularJS/ExtJS to Angular.

  • New in-product feedback widget:  A new "Feedback" button in the CMS navigation bar allows users to submit issues and suggestions directly to the Bloomreach Content product team.  Enabled by default via a Bloomreach-managed endpoint, it can be disabled in the CMS console, see documentation for more details. Submissions do not generate support tickets or direct replies. For urgent issues or required responses, contact Bloomreach Support.

See the 17.2.0 release notes for a full list.

Upgrade Steps

Perform Generic Minor Upgrade Steps

Follow the generic instructions for minor upgrades.

AI Service Module Spring AI 2.0 Upgrade

The following changes affect the AI module. If your project configures the AI Content Assistant via properties or Essentials, review and update the following before upgrading:

PromptLoggerAdvisor log level change
The log level for the prompt logger has been changed from INFO to DEBUG. Make sure you update your logging configurations if needed.

Usage Audit Logging
The log level for the UsageLoggingStore logger has been changed from INFO to DEBUG. Make sure you update your logging configurations if needed.

Vertex provider renamed
Google and Spring AI have renamed the AI provider from VertexAIGemini to GoogleGenAiVertex. Make sure to update your AI configuration if using the Google provider.

Removal of completions-path/embeddings-path
The provider for OpenAI has dropped support for the configuration properties completions-path and embeddings-path. It is not possible to specify those anymore.

Change of OpenAI api url
The default url for OpenAI api endpoints (config property spring.ai.openai.api.url) was changed from https://api.openai.com/v1 to https://api.openai.com.

Check Custom Project Code for Incompatibilities With Upgraded Libraries

Because of third party library upgrades that may introduce backward compatibility issues, there's a chance that project code doesn't build or run well any more. In that case, look into the specifics and adjust the project code to use the latest library correctly.

Detailed Release Notes

See also the detailed release notes for more information.

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?