Skip to content

Commit d14d4f3

Browse files
kilfoyleeedugon
kilfoyle
and
eedugon
authored
Replace Beats/Agent 'has not yet been released' with install commands (#854)
During migration the install steps for Elastic Agent and Beats were replaced with the "this version has not yet been released" string that was used conditionally for yet-to-be released versions. So, this adds back in the actual install steps. See related PR for Beats docs: **original** <img width="606" alt="Screenshot 2025-03-20 at 11 38 28 AM" src="https://github.com/user-attachments/assets/d4938c1c-e159-455b-9ede-d4f3c556853c" /> **fixed** <img width="672" alt="screen" src="https://github.com/user-attachments/assets/65da7f1b-147a-4e4a-8f3a-5926f1b1fcc3" /> **Examples** - Tutorial Monitor a Java Application: - [Install and configure Filebeat tabs](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/854/solutions/observability/apps/tutorial-monitor-java-application#_install_and_configure_filebeat) - [Install and configure Metricbeat tabs](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/854/solutions/observability/apps/tutorial-monitor-java-application#_install_and_configure_metricbeat) - [Setup tabs with commands for Heartbeat](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/854/solutions/observability/apps/tutorial-monitor-java-application#_setup) - [Install standalone Elastic Agent](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/854/reference/fleet/install-standalone-elastic-agent): - The "download and extract the installation package" tabs in Step 1. Closes: #853 --------- Co-authored-by: Edu González de la Herrán <[email protected]>
1 parent 1323e69 commit d14d4f3

File tree

7 files changed

+319
-84
lines changed

7 files changed

+319
-84
lines changed

‎reference/fleet/air-gapped.md‎

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -110,11 +110,6 @@ There are different distributions available:
110110
* production: `docker.elastic.co/package-registry/distribution:production` - Packages available in the production registry ([https://epr.elastic.co](https://epr.elastic.co)). Please note that this image is updated every time a new version of a package gets published.
111111
* lite: `docker.elastic.co/package-registry/distribution:lite` - Subset of the most commonly used packages available in the production registry ([https://epr.elastic.co](https://epr.elastic.co)). Please note that this image is updated every time a new version of a package gets published.
112112

113-
::::{warning}
114-
Version 9.0.0-beta1 of the {{package-registry}} distribution has not yet been released.
115-
116-
::::
117-
118113

119114
To update the distribution image, re-pull the image and then restart the docker container.
120115

‎reference/fleet/install-standalone-elastic-agent.md‎

Lines changed: 53 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -28,23 +28,55 @@ To install and run {{agent}} standalone:
2828
::::{tab-set}
2929

3030
:::{tab-item} macOS
31-
Version 9.0.0-beta1 of {{agent}} has not yet been released.
31+
```shell subs=true
32+
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{stack-version}}-darwin-x86_64.tar.gz
33+
tar xzvf elastic-agent-{{stack-version}}-darwin-x86_64.tar.gz
34+
```
3235
:::
3336

3437
:::{tab-item} Linux
35-
Version 9.0.0-beta1 of {{agent}} has not yet been released.
38+
```shell subs=true
39+
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{stack-version}}-linux-x86_64.tar.gz
40+
tar xzvf elastic-agent-{{stack-version}}-linux-x86_64.tar.gz
41+
```
3642
:::
3743

3844
:::{tab-item} Windows
39-
Version 9.0.0-beta1 of {{agent}} has not yet been released.
45+
```shell subs=true
46+
# PowerShell 5.0+
47+
wget https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{stack-version}}-windows-x86_64.zip -OutFile elastic-agent-{{stack-version}}-windows-x86_64.zip
48+
Expand-Archive .\elastic-agent-{{stack-version}}-windows-x86_64.zip
49+
```
50+
Or manually:
51+
52+
1. Download the {{agent}} Windows zip file from the [download page](https://www.elastic.co/downloads/beats/elastic-agent).
53+
54+
2. Extract the contents of the zip file.
4055
:::
4156

4257
:::{tab-item} DEB
43-
Version 9.0.0-beta1 of {{agent}} has not yet been released.
58+
IMPORTANT:
59+
60+
* To simplify upgrading to future versions of {{agent}}, we recommended that you use the tarball distribution instead of the DEB distribution.
61+
* You can install {{agent}} in an `unprivileged` mode that does not require `root` privileges. Refer to [Run {{agent}} without administrative privileges](./elastic-agent-unprivileged.md) for details.
62+
63+
```shell subs=true
64+
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{stack-version}}-amd64.deb
65+
sudo dpkg -i elastic-agent-{{stack-version}}-amd64.deb
66+
```
4467
:::
4568

4669
:::{tab-item} RPM
47-
Version 9.0.0-beta1 of {{agent}} has not yet been released.
70+
IMPORTANT:
71+
72+
* To simplify upgrading to future versions of {{agent}}, we recommended that you use the tarball distribution instead of the RPM distribution.
73+
* You can install {{agent}} in an `unprivileged` mode that does not require `root` privileges. Refer to [Run {{agent}} without administrative privileges](./elastic-agent-unprivileged.md) for details.
74+
75+
76+
```shell subs=true
77+
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-{{stack-version}}-x86_64.rpm
78+
sudo rpm -vi elastic-agent-{{stack-version}}-x86_64.rpm
79+
```
4880
:::
4981

5082
::::
@@ -79,31 +111,31 @@ To install and run {{agent}} standalone:
79111
On macOS, Linux (tar package), and Windows, run the `install` command to install {{agent}} as a managed service and start the service. The DEB and RPM packages include a service unit for Linux systems with systemd, so just enable then start the service.
80112
::::
81113

82-
::::{tab-set}
114+
:::::{tab-set}
83115

84-
:::{tab-item} macOS
116+
::::{tab-item} macOS
85117

86-
::::{tip}
118+
:::{tip}
87119
You must run this command as the root user because some integrations require root privileges to collect sensitive data.
88-
::::
120+
:::
89121

90122
```shell
91123
sudo ./elastic-agent install
92124
```
93-
:::
125+
::::
94126

95-
:::{tab-item} Linux
127+
::::{tab-item} Linux
96128

97-
::::{tip}
129+
:::{tip}
98130
You must run this command as the root user because some integrations require root privileges to collect sensitive data.
99-
::::
131+
:::
100132

101133
```shell
102134
sudo ./elastic-agent install
103135
```
104-
:::
136+
::::
105137

106-
:::{tab-item} Windows
138+
::::{tab-item} Windows
107139

108140
Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select **Run As Administrator**).
109141

@@ -112,38 +144,30 @@ To install and run {{agent}} standalone:
112144
```shell
113145
.\elastic-agent.exe install
114146
```
115-
:::
116-
117-
:::{tab-item} DEB
118-
119-
::::{tip}
120-
You must run this command as the root user because some integrations require root privileges to collect sensitive data.
121147
::::
122148

149+
::::{tab-item} DEB
150+
123151
```shell
124152
sudo systemctl enable elastic-agent <1>
125153
sudo systemctl start elastic-agent
126154
```
155+
127156
1. The DEB package includes a service unit for Linux systems with systemd. On these systems, you can manage {{agent}} by using the usual systemd commands. If you don’t have systemd, run `sudo service elastic-agent start`.
128-
:::
129-
130-
:::{tab-item} RPM
131-
132-
::::{tip}
133-
You must run this command as the root user because some integrations require root privileges to collect sensitive data.
134157
::::
135158

159+
::::{tab-item} RPM
136160

137161
```shell
138162
sudo systemctl enable elastic-agent <1>
139163
sudo systemctl start elastic-agent
140164
```
141165

142166
1. The RPM package includes a service unit for Linux systems with systemd. On these systems, you can manage {{agent}} by using the usual systemd commands. If you don’t have systemd, run `sudo service elastic-agent start`.
143-
:::
144-
145167
::::
146168

169+
:::::
170+
147171
Refer to [Installation layout](/reference/fleet/installation-layout.md) for the location of installed {{agent}} files.
148172

149173
Because {{agent}} is installed as an auto-starting service, it will restart automatically if the system is rebooted.

‎solutions/observability/apps/tutorial-monitor-java-application.md‎

Lines changed: 96 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -377,23 +377,50 @@ To read the log file and send it to {{es}}, {{filebeat}} is required. To downloa
377377
:::::::{tab-set}
378378

379379
::::::{tab-item} DEB
380-
Version 9.0.0-beta1 of Filebeat has not yet been released.
380+
```shell subs=true
381+
curl -L -O https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-{{stack-version}}-amd64.deb
382+
sudo dpkg -i filebeat-{{stack-version}}-amd64.deb
383+
```
381384
::::::
382385

383386
::::::{tab-item} RPM
384-
Version 9.0.0-beta1 of Filebeat has not yet been released.
387+
```shell subs=true
388+
curl -L -O https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-{{stack-version}}-x86_64.rpm
389+
sudo rpm -vi filebeat-{{stack-version}}-x86_64.rpm
390+
```
385391
::::::
386392

387393
::::::{tab-item} MacOS
388-
Version 9.0.0-beta1 of Filebeat has not yet been released.
394+
```shell subs=true
395+
curl -L -O https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-{{stack-version}}-darwin-x86_64.tar.gz
396+
tar xzvf filebeat-{{stack-version}}-darwin-x86_64.tar.gz
397+
```
389398
::::::
390399

391400
::::::{tab-item} Linux
392-
Version 9.0.0-beta1 of Filebeat has not yet been released.
401+
```shell subs=true
402+
curl -L -O https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-{{stack-version}}-linux-x86_64.tar.gz
403+
tar xzvf filebeat-{{stack-version}}-linux-x86_64.tar.gz
404+
```
393405
::::::
394406

395407
::::::{tab-item} Windows
396-
Version 9.0.0-beta1 of Filebeat has not yet been released.
408+
1. Download the [Filebeat Windows zip file](https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-{{stack-version}}-windows-x86_64.zip).
409+
410+
2. Extract the contents of the zip file into `C:\Program Files`.
411+
412+
3. Rename the `filebeat-[version]-windows-x86_64` directory to `Filebeat`.
413+
414+
4. Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select *Run As Administrator*).
415+
416+
5. From the PowerShell prompt, run the following commands to install Filebeat as a Windows service:
417+
418+
```shell subs=true
419+
PS > cd 'C:\Program Files\Filebeat'
420+
PS C:\Program Files\Filebeat> .\install-service-filebeat.ps1
421+
```
422+
423+
NOTE: If script execution is disabled on your system, you need to set the execution policy for the current session to allow the script to run. For example: `PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-filebeat.ps1`.
397424
::::::
398425

399426
:::::::
@@ -1097,23 +1124,50 @@ To send metrics to {{es}}, {{metricbeat}} is required. To download and install {
10971124
:::::::{tab-set}
10981125
10991126
::::::{tab-item} DEB
1100-
Version 9.0.0-beta1 of Metricbeat has not yet been released.
1127+
```shell subs=true
1128+
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-{{stack-version}}-amd64.deb
1129+
sudo dpkg -i metricbeat-{{stack-version}}-amd64.deb
1130+
```
11011131
::::::
11021132
11031133
::::::{tab-item} RPM
1104-
Version 9.0.0-beta1 of Metricbeat has not yet been released.
1134+
```shell subs=true
1135+
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-{{stack-version}}-x86_64.rpm
1136+
sudo rpm -vi metricbeat-{{stack-version}}-x86_64.rpm
1137+
```
11051138
::::::
11061139
11071140
::::::{tab-item} MacOS
1108-
Version 9.0.0-beta1 of Metricbeat has not yet been released.
1141+
```shell subs=true
1142+
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-{{stack-version}}-darwin-x86_64.tar.gz
1143+
tar xzvf metricbeat-{{stack-version}}-darwin-x86_64.tar.gz
1144+
```
11091145
::::::
11101146
11111147
::::::{tab-item} Linux
1112-
Version 9.0.0-beta1 of Metricbeat has not yet been released.
1148+
```shell subs=true
1149+
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-{{stack-version}}-linux-x86_64.tar.gz
1150+
tar xzvf metricbeat-{{stack-version}}-linux-x86_64.tar.gz
1151+
```
11131152
::::::
11141153
11151154
::::::{tab-item} Windows
1116-
Version 9.0.0-beta1 of Metricbeat has not yet been released.
1155+
1. Download the [Metricbeat Windows zip file](https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-{{stack-version}}-windows-x86_64.zip).
1156+
1157+
2. Extract the contents of the zip file into `C:\Program Files`.
1158+
1159+
3. Rename the `metricbeat-[version]-windows-x86_64` directory to `Metricbeat`.
1160+
1161+
4. Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select *Run As Administrator*).
1162+
1163+
5. From the PowerShell prompt, run the following commands to install Metricbeat as a Windows service:
1164+
1165+
```shell subs=true
1166+
PS > cd 'C:\Program Files\Metricbeat'
1167+
PS C:\Program Files\Metricbeat> .\install-service-metricbeat.ps1
1168+
```
1169+
1170+
NOTE: If script execution is disabled on your system, you need to set the execution policy for the current session to allow the script to run. For example: `PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-metricbeat.ps1`.
11171171
::::::
11181172
11191173
:::::::
@@ -1713,23 +1767,50 @@ To send uptime data to {{es}}, {{heartbeat}} (the polling component) is required
17131767
:::::::{tab-set}
17141768
17151769
::::::{tab-item} DEB
1716-
Version 9.0.0-beta1 of Heartbeat has not yet been released.
1770+
```shell subs=true
1771+
curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-{{stack-version}}-amd64.deb
1772+
sudo dpkg -i heartbeat-{{stack-version}}-amd64.deb
1773+
```
17171774
::::::
17181775
17191776
::::::{tab-item} RPM
1720-
Version 9.0.0-beta1 of Heartbeat has not yet been released.
1777+
```shell subs=true
1778+
curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-{{stack-version}}-x86_64.rpm
1779+
sudo rpm -vi heartbeat-{{stack-version}}-x86_64.rpm
1780+
```
17211781
::::::
17221782
17231783
::::::{tab-item} MacOS
1724-
Version 9.0.0-beta1 of Heartbeat has not yet been released.
1784+
```shell subs=true
1785+
curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-{{stack-version}}-darwin-x86_64.tar.gz
1786+
tar xzvf heartbeat-{{stack-version}}-darwin-x86_64.tar.gz
1787+
```
17251788
::::::
17261789
17271790
::::::{tab-item} Linux
1728-
Version 9.0.0-beta1 of Heartbeat has not yet been released.
1791+
```shell subs=true
1792+
curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-{{stack-version}}-linux-x86_64.tar.gz
1793+
tar xzvf heartbeat-{{stack-version}}-linux-x86_64.tar.gz
1794+
```
17291795
::::::
17301796
17311797
::::::{tab-item} Windows
1732-
Version 9.0.0-beta1 of Heartbeat has not yet been released.
1798+
1. Download the [Heartbeat Windows zip file](https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-{{stack-version}}-windows-x86_64.zip).
1799+
1800+
2. Extract the contents of the zip file into `C:\Program Files`.
1801+
1802+
3. Rename the `heartbeat-[version]-windows-x86_64` directory to `Heartbeat`.
1803+
1804+
4. Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select *Run As Administrator*).
1805+
1806+
5. From the PowerShell prompt, run the following commands to install Heartbeat as a Windows service:
1807+
1808+
```shell subs=true
1809+
PS > cd 'C:\Program Files\Heartbeat'
1810+
PS C:\Program Files\Heartbeat> .\install-service-heartbeat.ps1
1811+
```
1812+
1813+
NOTE: If script execution is disabled on your system, you need to set the execution policy for the current session to allow the script to run. For example: `PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-heartbeat.ps1`.
17331814
::::::
17341815
17351816
:::::::

0 commit comments

Comments
 (0)