Skip to content

Commit 461c3d5

Browse files
Copilotbmorelli25
andauthored
Add Linux, Windows, DEB, and RPM standalone agent upgrade commands (#4187)
## Summary The standalone agent upgrade documentation only showed macOS commands. Added tabbed interface with simplified upgrade commands for all supported platforms: - **macOS**: `sudo elastic-agent upgrade 9.1.1` - **Linux**: `sudo elastic-agent upgrade 9.1.1` - **Windows**: `.\elastic-agent.exe upgrade 9.1.1` (as Administrator) - **DEB**: `sudo elastic-agent upgrade 9.1.1` - **RPM**: `sudo elastic-agent upgrade 9.1.1` The instructions leverage the fact that step 2 already directs users to navigate to the installation directory, so the code blocks only show the upgrade command itself. For DEB/RPM installations, the elastic-agent binary is already in PATH via systemd install. Uses same tab-set syntax as `install-standalone-elastic-agent.md`. ## Generative AI disclosure 1. Did you use a generative AI (GenAI) tool to assist in creating this contribution? - [x] Yes - [ ] No Tool(s) and model(s) used: GitHub Copilot (Claude) <!-- START COPILOT CODING AGENT SUFFIX --> <details> <summary>Original prompt</summary> > > ---- > > *This section details on the original issue you should resolve* > > <issue_title>[Fleet]: Standalone Agent Upgrade Commands not displayed for Non-macOS</issue_title> > <issue_description>**Description:** > Upgrade standalone agents section only displays macOS upgrade commands. Upgrade commands for other operating systems are missing. > > **Link:** > https://www.elastic.co/docs/reference/fleet/upgrade-standalone > > > **Screen-shot:** > > <img width="1601" height="740" alt="Image" src="https://github.com/user-attachments/assets/f324c36a-2986-43ea-8822-9a654789e754" /> > > **Whats working fine** > - Installation commands are available for all operating systems. > > **Expected Result** > Upgrade commands for standalone agents should be available for all supported operating systems/artifacts. </issue_description> > > <agent_instructions>Here's the file: https://github.com/elastic/docs-content/edit/main/reference/fleet/upgrade-standalone.md > > Add Linux, Windows, DEB, and RPM instructions. An example of the syntax is available here: https://www.elastic.co/docs/reference/fleet/install-standalone-elastic-agent (https://github.com/elastic/docs-content/edit/main/reference/fleet/install-standalone-elastic-agent.md).</agent_instructions> > > ## Comments on the Issue (you are @copilot in this section) > > <comments> > </comments> > </details> - Fixes elastic/ingest-docs#1876 <!-- START COPILOT CODING AGENT TIPS --> --- 💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey). --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: bmorelli25 <[email protected]> Co-authored-by: Brandon Morelli <[email protected]>
1 parent 6dce73d commit 461c3d5

File tree

1 file changed

+46
-5
lines changed

1 file changed

+46
-5
lines changed

reference/fleet/upgrade-standalone.md

Lines changed: 46 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,54 @@ To upgrade a standalone agent running on an edge node:
1313
1. Make sure the `elastic-agent` service is running.
1414
2. From the directory where {{agent}} is installed, run the `upgrade` command to upgrade to a new version. Not sure where the agent is installed? Refer to [Installation layout](/reference/fleet/installation-layout.md).
1515

16-
For example, on macOS, to upgrade the agent from version 8.8.0 to 8.8.1, you would run:
16+
For example, to upgrade the agent from version 9.1.0 to 9.1.1, you would run:
17+
18+
:::::{tab-set}
19+
20+
::::{tab-item} macOS
21+
22+
```shell
23+
sudo elastic-agent upgrade 9.1.1
24+
```
25+
26+
::::
27+
28+
::::{tab-item} Linux
29+
30+
```shell
31+
sudo elastic-agent upgrade 9.1.1
32+
```
33+
34+
::::
35+
36+
::::{tab-item} Windows
37+
38+
As an Administrator, run:
1739

1840
```shell
19-
cd /Library/Elastic/Agent/
20-
sudo elastic-agent upgrade 8.8.1
41+
.\elastic-agent.exe upgrade 9.1.1
2142
```
2243

44+
::::
45+
46+
::::{tab-item} DEB
47+
48+
```shell
49+
sudo elastic-agent upgrade 9.1.1
50+
```
51+
52+
::::
53+
54+
::::{tab-item} RPM
55+
56+
```shell
57+
sudo elastic-agent upgrade 9.1.1
58+
```
59+
60+
::::
61+
62+
:::::
63+
2364

2465
This command upgrades the binary. Your agent policy should continue to work, but you might need to upgrade it to use new features and capabilities.
2566

@@ -53,7 +94,7 @@ In the event of a private GPG key rotation, you can use the following options wi
5394
Example:
5495

5596
```yaml
56-
./elastic-agent upgrade 8.8.0 --skip-verify
97+
./elastic-agent upgrade 9.1.0 --skip-verify
5798
```
5899

59100

@@ -63,7 +104,7 @@ In the event of a private GPG key rotation, you can use the following options wi
63104
Example:
64105

65106
```yaml
66-
./elastic-agent upgrade 8.8.0 --pgp-path /home/elastic-agent/GPG-KEY-elasticsearch
107+
./elastic-agent upgrade 9.1.0 --pgp-path /home/elastic-agent/GPG-KEY-elasticsearch
67108
```
68109

69110

0 commit comments

Comments
 (0)