Skip to content

Update upgrade restrictions for agents in documentation - #1916

Merged
vishaangelova merged 3 commits into
8.19from
rseldner-patch-5
Jul 27, 2026
Merged

Update upgrade restrictions for agents in documentation#1916
vishaangelova merged 3 commits into
8.19from
rseldner-patch-5

Conversation

@rseldner

Copy link
Copy Markdown
Contributor

Fixed outdated restrictions verbiage on upgrading agents with respect to Fleet Server versions and minor version limitations.

I used wording that would match the equivalent 9.x doc:
https://www.elastic.co/docs/reference/fleet/upgrade-elastic-agent#upgrade-agent-restrictions

That said, I think the existing 9.x wording is a bit convoluted. It leads with the restriction, then walks it back with a "so while you can... but you cannot..." to note the permissive case of maintenance upgrades... which I think is more useful to state up front. I'd suggest something more straightforward for a future change:

{agent} can be upgraded to a newer maintenance release within its current minor version, but not to a newer minor version than {fleet-server}. For example, an 8.18.0 {fleet-server} supports upgrading {agents} up to any 8.18.x version, but not to 8.19.0. Before you upgrade {agents} to a newer minor version, you should first upgrade any agents that are acting as {fleet-server} (any agents that have a {fleet-server} policy associated with them).

Fixed outdated restrictions verbiage on upgrading agents with respect to fleet-server versions and minor version limitations.

Wording now matches the equivalent 9.x doc 

https://www.elastic.co/docs/reference/fleet/upgrade-elastic-agent#upgrade-agent-restrictions
@rseldner
rseldner requested a review from a team as a code owner July 24, 2026 21:55
@rseldner rseldner added documentation Improvements or additions to documentation Team:Docs Team:Elastic-Agent-Control-Plane Label for the Agent Control Plane team labels Jul 24, 2026
@github-actions

Copy link
Copy Markdown

🤖 GitHub comments

Just comment with:

  • run docs-build : Re-trigger the docs validation. (use unformatted text in the comment!)

@github-actions

Copy link
Copy Markdown

A documentation preview will be available soon.

Request a new doc build by commenting
  • Rebuild this PR: run docs-build
  • Rebuild this PR and all Elastic docs: run docs-build rebuild

run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.

If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.

Comment thread docs/en/ingest-management/fleet/upgrade-elastic-agent.asciidoc Outdated
@vishaangelova
vishaangelova requested a review from a team as a code owner July 27, 2026 11:21
@vishaangelova
vishaangelova enabled auto-merge (squash) July 27, 2026 11:21
@vishaangelova
vishaangelova merged commit 6699892 into 8.19 Jul 27, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Team:Docs Team:Elastic-Agent-Control-Plane Label for the Agent Control Plane team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants