Skip to content

Expand migrate guide - #16756

Merged
javanna merged 14 commits into
apache:mainfrom
javanna:docs/migrate_11
Oct 7, 2026
Merged

javanna merged 14 commits into
apache:mainfrom
javanna:docs/migrate_11

Conversation

@javanna

@javanna javanna commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

I went through the migrate guide and added some changes that I thought deserve a mention.

I also added some code snippets where helpful.

I also clarified the complement regexp syntax entry: it was deprecated in Lucene 10 and remove in Lucene 11.

@javanna javanna added this to the 11.0.0 milestone Oct 1, 2026
@javanna javanna changed the title Extend migrate guide Expand migrate guide Oct 2, 2026
Comment thread lucene/MIGRATE.md

```java
// Opening an index created with Lucene 10.x in Lucene 11.x+
// Opening a 10.x index in 11 still works (MIN_SUPPORTED_MAJOR is 10).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I'm surprised we bumped MIN_SUPPORTED_MAJOR to 10 -- is it really not possible to read 9.x indexes from 11?

@javanna javanna Oct 5, 2026 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This is old news that does not take #16741 into account . Reading 9.x indices is possible without it, but only via the expert read-only API. An IndexWriter can't be opened against those indices without the changes from #16741 . The wording here mentions "opening" but what is implied is full support as far as I understand it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I guess we will update this once #16741 is merged?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

that's the plan. Good reason to get this one in for now and resolve conflicts in the linked PR.

@romseygeek romseygeek left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This is great, thanks @javanna

Comment thread lucene/MIGRATE.md Outdated
Comment thread lucene/MIGRATE.md

```java
// Opening an index created with Lucene 10.x in Lucene 11.x+
// Opening a 10.x index in 11 still works (MIN_SUPPORTED_MAJOR is 10).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I guess we will update this once #16741 is merged?

Co-authored-by: Alan Woodward <romseygeek@gmail.com>
@javanna
javanna merged commit 120b3bc into apache:main Oct 7, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants