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

versions.props update

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

versions.lock update

gradlew --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.