Skip to content

Commit 354dc53

Browse files
committed
Add agent upgrade steps for DEB & RPM
1 parent cd57109 commit 354dc53

File tree

1 file changed

+51
-2
lines changed

1 file changed

+51
-2
lines changed

docs/en/ingest-management/fleet/upgrade-elastic-agent.asciidoc

Lines changed: 51 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@ By default, {agent}s require internet access to perform binary upgrades from
3030
{agent}s to download binaries from it. For more information, refer to
3131
<<air-gapped>>.
3232

33-
NOTE: The upgrade feature is not supported for upgrading DEB/RPM packages or
34-
Docker images.
33+
NOTE: The upgrade feature is not supported for upgrading DEB/RPM packages or Docker images.
34+
Refer to <<upgrade-system-packages>> to upgrade a DEB or RPM package manually.
3535

3636
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.
3737

@@ -262,3 +262,52 @@ To force selected agents to upgrade immediately when the upgrade is
262262
triggered, select **Immediately**. Avoid using this setting for batches of more
263263
than 10 agents.
264264
. Restart the upgrades.
265+
266+
[discrete]
267+
[[upgrade-system-packages]]
268+
== Upgrade RPM and DEB system packages
269+
270+
If you have installed and enrolled {agent} using either a DEB (for a Debian-based Linux distribution) or RPM (for a RedHat-based Linux distribution) install package, the upgrade cannot be managed by {fleet}.
271+
Instead, you can perform the upgrade using these steps.
272+
273+
For installation steps refer to <<install-fleet-managed-elastic-agent>>.
274+
275+
[discrete]
276+
=== Upgrade a DEB {agent} installation:
277+
278+
. Download the {agent} Debian install package for the release that you want to upgrade to:
279+
+
280+
[source,terminal,subs="attributes"]
281+
----
282+
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{version}-amd64.deb
283+
----
284+
285+
. Upgrade {agent} to the target release:
286+
+
287+
[source,terminal,subs="attributes"]
288+
----
289+
sudo dpkg -i elastic-agent-{version}-amd64.deb
290+
----
291+
292+
. Confirm in {fleet} that the agent has been upgraded to the target version.
293+
Note that the **Upgrade agent** option in the **Actions** menu next to the agent will be disabled since [fleet]-managed upgrades are not supported for this package type.
294+
295+
[discrete]
296+
=== Upgrade an RPM {agent} installation:
297+
298+
. Download the {agent} RPM install package for the release that you want to upgrade to:
299+
+
300+
[source,terminal,subs="attributes"]
301+
----
302+
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{version}-x86_64.rpm
303+
----
304+
305+
. Upgrade {agent} to the target release:
306+
+
307+
[source,terminal,subs="attributes"]
308+
----
309+
sudo rpm -U elastic-agent-{version}-x86_64.rpm
310+
----
311+
312+
. Confirm in {fleet} that the agent has been upgraded to the target version.
313+
Note that the **Upgrade agent** option in the **Actions** menu next to the agent will be disabled since [fleet]-managed upgrades are not supported for this package type.

0 commit comments

Comments
 (0)