Skip to content

Enable creation of backwards-compatible extracts#1052

Merged
lonvia merged 2 commits intokomoot:masterfrom
lonvia:backward-compatible-photon
Apr 15, 2026
Merged

Enable creation of backwards-compatible extracts#1052
lonvia merged 2 commits intokomoot:masterfrom
lonvia:backward-compatible-photon

Conversation

@lonvia
Copy link
Copy Markdown
Collaborator

@lonvia lonvia commented Apr 14, 2026

As already mentioned in #1029 (comment), there is an issue with OpenSearch (OS) where OS databases are forward-compatible but not backwards. You can use a database created on an older version of the 3.x series with a newer minor version but not vise versa.

The database extracts on the download server are supposed to work for all releases in a major series of Photon. There simply is no bandwidth to create separate extracts for each minor release. So, in order to make that work, the extracts need to be created against the smallest used OS version in the major Photon release series.

To make that work and still get the newest available minor OS version with each Photon release, I've come up with the following plan: a) always keep the master branch on the latest OS 3.x version and also include these in releases. b) When making a release build a special version of Photon with the lower OS version (currently 3.5) and deploy that on the extract server. This gives us OS 3.5-compatible database extracts while everybody can run a Photon version with the latest and greatest (and securest) OS.

This PR adds two things to make that happen:

  1. The OpenSearch version to build into Photon is now configurable on the command line: ./gradlew assemble -PosVersion=3.5.0.0.
  2. A CI tasks checks that OpenSearch doesn't sneak in other incompatibilities that need to be taken care of. The tasks builds a database with a downgraded Photon from master and then runs serve against Photon 1.0.1 (currently the lowest version in the 1.x series that needs to be compatible) and Photon master with latest OS.

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Reviewed by Cursor Bugbot for commit e876860. Configure here.

Comment thread .github/workflows/ci.yml Outdated
@lonvia lonvia force-pushed the backward-compatible-photon branch from e876860 to e5d54ac Compare April 14, 2026 20:38
@lonvia lonvia merged commit e4e46fa into komoot:master Apr 15, 2026
5 checks passed
@lonvia lonvia deleted the backward-compatible-photon branch April 15, 2026 07:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant