4.8 to 5.0 Table of Contents
Introduction
This upgrade guide provides a step by step process for performing an upgrade of an existing Brightspot application from version 4.8.x to the version 5.0.x, where .x represents the latest available patch. Covered scenarios may not be applicable to every codebase, so make sure to check for any prerequisite conditions before performing each step.
Please report any feedback including missing documentation, documentation errors or clarifications.
Clean diffs
Brightspot recommends avoiding unnecessary file changes which result in noisy diffs. Brightspot also recommends disabling auto-formatting on your IDE/editor to ensure that no unintended formatting changes occur.
By ensuring that the diff is clean (i.e. no extra formatting changes), you can promote thorough reviews of the upgrade code by the reviewer, as well as avoid unexpected merge conflicts with the rest of your engineering team.
Flag/file any unexpected issues
If anything occurs during an upgrade that is unexpected, or if something is unclear based on the documentation, make sure to flag it to a Brightspot representative. This will ensure that everything is being done correctly, and any gaps in documentation are handled.
Keep commits small and succinct
Ensure that commits are small and specific to the task at hand. This can help reviews, but can also ensure that reverting changes is easier to execute (for example, if a lot of auto-formatting happened, Brightspot would want to ensure that can be easily undone).
Clean operation if active development
If there is active development on the project that you are upgrading, discuss a plan with the project team before you begin to help avoid merge conflicts.
Relevant versions
Below are the relevant versions to be used in the following guides:
- Brightspot:
5.0.x(latest available patch) - Component-lib: 4.5.X (latest available patch)
- Java: 21
- Brightspot-GO: Refer to below table
| Current Version Range | Upgrade To Version |
|---|---|
| 0.x | 0.20.X |
| 1.x | 1.8.x |
Tomcat versions
| Configuration | Image Tag |
|---|---|
| Tomcat 9 / JDK 11 | 9.0.111.20260130-jdk11-temurin |
| Tomcat 10 / JDK 11 | 10.1.48.20260130-jdk11-temurin-noble |
| Tomcat 10 / JDK 17 | 10.1.48.20260130-jdk17-temurin-noble |
| Tomcat 10 / JDK 21 | 10.1.48.20260130-jdk21-temurin-noble |
Step 1: Java 21 / Tomcat 10.1
Brightspot 5.0 requires Java 21 and Tomcat 10.1. This step covers updating your Java version, migrating to Jakarta EE, and updating container images.
Brightspot Enterprise 4.8 to 5.0 Developer Upgrade Guide → Java 21 / Tomcat 10.1 Upgrade Guide
Step 2: Breaking Changes
When upgrading to 5.0, there are some breaking changes that need to be accounted for.
Brightspot Enterprise 4.8 to 5.0 Developer Upgrade Guide → 5.0 Breaking Changes Guide
Step 3: 5.0 Features
On every project being upgraded to 5.0, you should assess the feature implementation guides below. Not all features will be relevant for every project.
Follow the below guide for more information on implementing these features.
Brightspot Enterprise 4.8 to 5.0 Developer Upgrade Guide → Adding 5.0 Features Guide