Skip to content

Commit

Permalink
Add restrictions to agent upgrade docs (#971)
Browse files Browse the repository at this point in the history
* Add restrictions to agent upgrade docs

* Fix spelling of 'eligible'

(cherry picked from commit 7cf7c2d)
  • Loading branch information
kilfoyle authored and mergify[bot] committed May 3, 2024
1 parent 8e7dc38 commit d584cea
Showing 1 changed file with 16 additions and 1 deletion.
17 changes: 16 additions & 1 deletion docs/en/ingest-management/fleet/upgrade-elastic-agent.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,22 @@ Docker images.

For a detailed view of the {agent} upgrade process and the interactions between {fleet}, {agent}, and {es}, refer to the link:https://github.com/elastic/elastic-agent/blob/main/docs/upgrades.md[Communications amongst components] diagram in the `elastic-agent` GitHub repository.

[discrete]
[[upgrade-agent-restrictions]]
== Restrictions

Note the following restrictions with upgrading an {agent}:

* {agent} cannot be upgraded to a version higher than the highest currently installed version of {fleet-server}.
* To be upgradeable, {agent} must not be running inside a container.
* To be upgradeable in a Linux environment, {agent} must be running as a service. The Linux Tar install instructions for {agent} provided in {fleet} include the commands to run it as a service. {agent} RPM and DEB system packages cannot be upgraded through {fleet}.

These restrictions apply whether you are upgrading {agents} individually or in bulk. In the event that an upgrade isn't eligible, {fleet} generates a warning message when you attempt the upgrade.

[discrete]
[[upgrade-agent]]
== Upgrading {agent}

To upgrade your {agent}s, go to *Management > {fleet} > Agents* in {kib}. You
can perform the following upgrade-related actions:

Expand Down Expand Up @@ -62,7 +78,6 @@ can perform the following upgrade-related actions:

|===


[discrete]
[[upgrade-an-agent]]
== Upgrade a single {agent}
Expand Down

0 comments on commit d584cea

Please sign in to comment.