Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add restrictions to agent upgrade docs #971

Merged
merged 2 commits into from
Mar 13, 2024
Merged

Add restrictions to agent upgrade docs #971

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fa42054
Add restrictions to agent upgrade docs
kilfoyle Mar 12, 2024
fff169f
Fix spelling of 'eligible'
kilfoyle Mar 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion docs/en/ingest-management/fleet/upgrade-elastic-agent.asciidoc
View file
Open in desktop
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