Skip to content

Add known issue for upgrading to 9.2.4#140738

Merged
rjernst merged 2 commits intoelastic:mainfrom
rjernst:docs/xcontent_issue_9.2.4
Jan 15, 2026
Merged

Add known issue for upgrading to 9.2.4#140738
rjernst merged 2 commits intoelastic:mainfrom
rjernst:docs/xcontent_issue_9.2.4

Conversation

@rjernst
Copy link
Member

@rjernst rjernst commented Jan 15, 2026

Backports for #139910 were released in different releases, causing some upgrade paths to be broken. This commit adds a note about a failure that can occur between 9.1.10 and 9.2.4.

Backports for elastic#139910
were released in different releases, causing some upgrade paths to be
broken. This commit adds a note about a failure that can occur between
9.1.10 and 9.2.4.
@rjernst rjernst added >docs General docs changes :Core/Infra/Core Core issues without another label labels Jan 15, 2026
@elasticsearchmachine elasticsearchmachine added v9.4.0 Team:Core/Infra Meta label for core/infra team Team:Docs Meta label for docs team labels Jan 15, 2026
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-core-infra (Team:Core/Infra)

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/core-docs (Team:Docs)

Copy link
Contributor

@DaveCTurner DaveCTurner left a comment

Choose a reason for hiding this comment

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

LGTM


* Upgrading from 9.1.10 to 9.2.4 may cause the following error:

```org.elasticsearch.xcontent.XContentParseException: [-1:107008] [node_shutdown_info] unknown field [shutdown_started_millis] did you mean [shutdown_startedmillis]```
Copy link
Contributor

Choose a reason for hiding this comment

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

Wondering, should it mention the exception that bubbles up from this? Might be easy to miss above far down the stack trace

fatal exception while booting Elasticsearch org.elasticsearch.ElasticsearchException: failed to load metadata at org.elasticsearch.gateway.GatewayMetaState.start(GatewayMetaState.java:119) ~[elasticsearch-9.2.4.jar:?] at [..] Caused by: org.elasticsearch.gateway.CorruptStateException: org.elasticsearch.xcontent.XContentParseException: [-1:107032] [node_shutdown] failed to parse field [nodes]

@rjernst
Copy link
Member Author

rjernst commented Jan 15, 2026

@mosche @leemthompo I added additional context and made the example a block as suggested.

@github-actions
Copy link
Contributor

🔍 Preview links for changed docs

@github-actions
Copy link
Contributor

ℹ️ Important: Docs version tagging

👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version.

We use applies_to tags to mark version-specific features and changes.

Expand for a quick overview

When to use applies_to tags:

✅ At the page level to indicate which products/deployments the content applies to (mandatory)
✅ When features change state (e.g. preview, ga) in a specific version
✅ When availability differs across deployments and environments

What NOT to do:

❌ Don't remove or replace information that applies to an older version
❌ Don't add new information that applies to a specific version without an applies_to tag
❌ Don't forget that applies_to tags can be used at the page, section, and inline level

🤔 Need help?

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

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

LGTM

@rjernst rjernst merged commit 499d368 into elastic:main Jan 15, 2026
12 checks passed
@rjernst rjernst deleted the docs/xcontent_issue_9.2.4 branch January 15, 2026 17:29
spinscale pushed a commit to spinscale/elasticsearch that referenced this pull request Jan 21, 2026
Backports for elastic#139910
were released in different releases, causing some upgrade paths to be
broken. This commit adds a note about a failure that can occur between
9.1.10 and 9.2.4.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

:Core/Infra/Core Core issues without another label >docs General docs changes Team:Core/Infra Meta label for core/infra team Team:Docs Meta label for docs team v9.4.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

Comments