Skip to content

Commit 2a3b5b3

Browse files
committed
Add known issue for Elastic Agent failing to enroll into Fleet
1 parent 189ee29 commit 2a3b5b3

File tree

1 file changed

+147
-8
lines changed

1 file changed

+147
-8
lines changed

docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc

Lines changed: 147 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,29 @@ Also see:
3737

3838
Review important information about the 8.17.6 release.
3939

40+
[discrete]
41+
[[known-issues-8.17.6]]
42+
=== Known issues
43+
44+
[[known-issue-1800-8-17-6]]
45+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
46+
[%collapsible]
47+
====
48+
49+
*Details*
50+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
51+
52+
[source,shell]
53+
----
54+
Error: the command is executed as root but the program files are not owned by the root user.
55+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
56+
----
57+
58+
*Impact* +
59+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
60+
61+
====
62+
4063
[discrete]
4164
[[enhancements-8.17.6]]
4265
=== Enhancements
@@ -46,16 +69,36 @@ Review important information about the 8.17.6 release.
4669

4770
// end 8.17.6 relnotes
4871

49-
50-
51-
5272
// begin 8.17.5 relnotes
5373

5474
[[release-notes-8.17.5]]
5575
== {fleet} and {agent} 8.17.5
5676

5777
Review important information about the 8.17.5 release.
5878

79+
[discrete]
80+
[[known-issues-8.17.5]]
81+
=== Known issues
82+
83+
[[known-issue-1800-8-17-5]]
84+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
85+
[%collapsible]
86+
====
87+
88+
*Details*
89+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
90+
91+
[source,shell]
92+
----
93+
Error: the command is executed as root but the program files are not owned by the root user.
94+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
95+
----
96+
97+
*Impact* +
98+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
99+
100+
====
101+
59102
[discrete]
60103
[[enhancements-8.17.5]]
61104
=== Enhancements
@@ -83,8 +126,6 @@ Review important information about the 8.17.5 release.
83126

84127
// end 8.17.5 relnotes
85128

86-
87-
88129
// begin 8.17.4 relnotes
89130

90131
[[release-notes-8.17.4]]
@@ -119,6 +160,25 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m
119160
120161
====
121162

163+
[[known-issue-1800-8-17-4]]
164+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
165+
[%collapsible]
166+
====
167+
168+
*Details*
169+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
170+
171+
[source,shell]
172+
----
173+
Error: the command is executed as root but the program files are not owned by the root user.
174+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
175+
----
176+
177+
*Impact* +
178+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
179+
180+
====
181+
122182
[discrete]
123183
[[new-features-8.17.4]]
124184
=== New features
@@ -190,6 +250,25 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m
190250
191251
====
192252

253+
[[known-issue-1800-8-17-3]]
254+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
255+
[%collapsible]
256+
====
257+
258+
*Details*
259+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
260+
261+
[source,shell]
262+
----
263+
Error: the command is executed as root but the program files are not owned by the root user.
264+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
265+
----
266+
267+
*Impact* +
268+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
269+
270+
====
271+
193272
[discrete]
194273
[[enhancements-8.17.3]]
195274
=== Enhancements
@@ -221,6 +300,28 @@ Review important information about the {fleet} and {agent} 8.17.2 release.
221300
{fleet-server}::
222301
* Upgrade `golang.org/x/net` to v0.34.0 and `golang.org/x/crypto` to v0.32.0. {fleet-server-pull}4405[#4405]
223302

303+
[discrete]
304+
[[known-issues-8.17.2]]
305+
=== Known issues
306+
307+
[[known-issue-1800-8-17-2]]
308+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
309+
[%collapsible]
310+
====
311+
312+
*Details*
313+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
314+
315+
[source,shell]
316+
----
317+
Error: the command is executed as root but the program files are not owned by the root user.
318+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
319+
----
320+
321+
*Impact* +
322+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
323+
324+
====
224325

225326
[discrete]
226327
[[enhancements-8.17.2]]
@@ -277,6 +378,25 @@ As a workaround, you can upgrade your deployment to 8.17.1 in which this issue h
277378
278379
====
279380

381+
[[known-issue-1800-8-17-1]]
382+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
383+
[%collapsible]
384+
====
385+
386+
*Details*
387+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
388+
389+
[source,shell]
390+
----
391+
Error: the command is executed as root but the program files are not owned by the root user.
392+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
393+
----
394+
395+
*Impact* +
396+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
397+
398+
====
399+
280400
[discrete]
281401
[[new-features-8.17.1]]
282402
=== New features
@@ -301,7 +421,7 @@ The 8.17.1 release added the following new and notable features.
301421

302422
{fleet-server}::
303423
* Do not set the `unenrolled_at` attribute when the audit/unenroll API is called. {fleet-server-pull}4221[#4221] {agent-issue}6213[#6213]
304-
* Remove PGP endpoint auth requirement so that air-gapped {agents} can retreive a PGP key from {fleet-server}. {fleet-server-pull}4256[#4256] {fleet-server-issue}4255[#4255]
424+
* Remove PGP endpoint auth requirement so that air-gapped {agents} can retrieve a PGP key from {fleet-server}. {fleet-server-pull}4256[#4256] {fleet-server-issue}4255[#4255]
305425

306426
{agent}::
307427
* During uninstall, call the audit or unenroll API before components are stopped, if {agent} is running a {fleet-server} instance. {agent-pull}6085[#6085] {agent-issue}5752[#5752]
@@ -338,12 +458,12 @@ impact to your application.
338458
[%collapsible]
339459
====
340460
*Details* +
341-
A known issue in the {agent} may prevent it from being targetted with an upgrade action for a future release.
461+
A known issue in the {agent} may prevent it from being targeted with an upgrade action for a future release.
342462
This may occur if the Defend integration is used and the agent is stopped on a running instance for too long.
343463
An agent may be stopped as part of an upgrade process.
344464
345465
*Impact* +
346-
A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occuring.
466+
A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occurring.
347467
348468
If you have agents that are affected, the workaround is as follows:
349469
[source,shell]
@@ -356,6 +476,25 @@ curl -XPOST -H 'Authorization: Bearer ${TOKEN}' -H 'x-elastic-product-origin:fle
356476
----
357477
====
358478

479+
[[known-issue-1800-8-17-0]]
480+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
481+
[%collapsible]
482+
====
483+
484+
*Details*
485+
On Windows, an installed {agent} that was previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Enrollment fails with the following error:
486+
487+
[source,shell]
488+
----
489+
Error: the command is executed as root but the program files are not owned by the root user.
490+
For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
491+
----
492+
493+
*Impact* +
494+
The issue affects {agent} installed on Windows. There is no resolution or workaround at this time, but a bug fix is expected in a later maintenance release.
495+
496+
====
497+
359498
[discrete]
360499
[[new-features-8.17.0]]
361500
=== New features

0 commit comments

Comments
 (0)