lucene-upgrade.md

Lucene upgrade steps

Read

https://lucene.apache.org/core/9_4_0/MIGRATE.html

Start

Create a new branch locally e.g. git checkout -b lucene940 -t origin/main for upgrading to Lucene 9.4.0 version.

Build

gradle/libs.versions.toml update

- org.apache.lucene:*=9.3.0
+ org.apache.lucene:*=9.4.0

lockfiles update

./gradlew resolveAndLockAll --write-locks

solr/licenses update

./gradlew updateLicenses

git add solr/licenses

Code

./gradlew compileJava

• adjust for signature changes e.g.
  • int to long type change
  • additional or removed constructor arguments
  • additional abstract base class or interface methods
  • inner classes becoming outer classes
• codec changes (if any)
  • conceptually s/org.apache.lucene.codecs.lucene9x.Lucene9x/org.apache.lucene.codecs.lucene94.Lucene94

Test

./gradlew compileTestJava

./gradlew precommit

./gradlew test

Finish

Push the local branch to github (fork) and open a pull request.

Looking for something else?

Thanks for reading these upgrade steps! But perhaps you were looking for information on trying out prerelease Lucene changes or joint local Solr and Lucene development? If so then please see the 'Update Lucene prerelease' and 'Lucene local dependency substitution' sections in the dev-docs/gradle-help/dependencies.txt documentation.