Skip to content

Commit 5f695b2

Browse files
committed
Add known issue for Elastic Agent failing to enroll into Fleet
1 parent ec1efa3 commit 5f695b2

File tree

1 file changed

+122
-8
lines changed

1 file changed

+122
-8
lines changed

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

Lines changed: 122 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,28 @@ Review important information about the 8.17.7 release.
5656

5757
Review important information about the 8.17.6 release.
5858

59+
[discrete]
60+
[[known-issues-8.17.6]]
61+
=== Known issues
62+
63+
[[known-issue-1800-8-17-6]]
64+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
65+
[%collapsible]
66+
====
67+
68+
*Details* +
69+
There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Attempting to enroll the {agent} fails with the following error:
70+
71+
[source,console-result]
72+
----
73+
Error: the command is executed as root but the program files are not owned by the root user.
74+
----
75+
76+
*Impact* +
77+
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.
78+
79+
====
80+
5981
[discrete]
6082
[[enhancements-8.17.6]]
6183
=== Enhancements
@@ -65,16 +87,35 @@ Review important information about the 8.17.6 release.
6587

6688
// end 8.17.6 relnotes
6789

68-
69-
70-
7190
// begin 8.17.5 relnotes
7291

7392
[[release-notes-8.17.5]]
7493
== {fleet} and {agent} 8.17.5
7594

7695
Review important information about the 8.17.5 release.
7796

97+
[discrete]
98+
[[known-issues-8.17.5]]
99+
=== Known issues
100+
101+
[[known-issue-1800-8-17-5]]
102+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
103+
[%collapsible]
104+
====
105+
106+
*Details* +
107+
There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Attempting to enroll the {agent} fails with the following error:
108+
109+
[source,console-result]
110+
----
111+
Error: the command is executed as root but the program files are not owned by the root user.
112+
----
113+
114+
*Impact* +
115+
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.
116+
117+
====
118+
78119
[discrete]
79120
[[enhancements-8.17.5]]
80121
=== Enhancements
@@ -102,8 +143,6 @@ Review important information about the 8.17.5 release.
102143

103144
// end 8.17.5 relnotes
104145

105-
106-
107146
// begin 8.17.4 relnotes
108147

109148
[[release-notes-8.17.4]]
@@ -138,6 +177,24 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m
138177
139178
====
140179

180+
[[known-issue-1800-8-17-4]]
181+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
182+
[%collapsible]
183+
====
184+
185+
*Details* +
186+
There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Attempting to enroll the {agent} fails with the following error:
187+
188+
[source,console-result]
189+
----
190+
Error: the command is executed as root but the program files are not owned by the root user.
191+
----
192+
193+
*Impact* +
194+
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.
195+
196+
====
197+
141198
[discrete]
142199
[[new-features-8.17.4]]
143200
=== New features
@@ -209,6 +266,24 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m
209266
210267
====
211268

269+
[[known-issue-1800-8-17-3]]
270+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
271+
[%collapsible]
272+
====
273+
274+
*Details* +
275+
There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Attempting to enroll the {agent} fails with the following error:
276+
277+
[source,console-result]
278+
----
279+
Error: the command is executed as root but the program files are not owned by the root user.
280+
----
281+
282+
*Impact* +
283+
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.
284+
285+
====
286+
212287
[discrete]
213288
[[enhancements-8.17.3]]
214289
=== Enhancements
@@ -240,6 +315,27 @@ Review important information about the {fleet} and {agent} 8.17.2 release.
240315
{fleet-server}::
241316
* Upgrade `golang.org/x/net` to v0.34.0 and `golang.org/x/crypto` to v0.32.0. {fleet-server-pull}4405[#4405]
242317

318+
[discrete]
319+
[[known-issues-8.17.2]]
320+
=== Known issues
321+
322+
[[known-issue-1800-8-17-2]]
323+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
324+
[%collapsible]
325+
====
326+
327+
*Details* +
328+
There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Attempting to enroll the {agent} fails with the following error:
329+
330+
[source,console-result]
331+
----
332+
Error: the command is executed as root but the program files are not owned by the root user.
333+
----
334+
335+
*Impact* +
336+
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.
337+
338+
====
243339

244340
[discrete]
245341
[[enhancements-8.17.2]]
@@ -296,6 +392,24 @@ As a workaround, you can upgrade your deployment to 8.17.1 in which this issue h
296392
297393
====
298394

395+
[[known-issue-1800-8-17-1]]
396+
.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
397+
[%collapsible]
398+
====
399+
400+
*Details* +
401+
There is a known issue where an {agent} installed on Windows and previously enrolled into {fleet} is unable to re-enroll after the {agent} is upgraded. Attempting to enroll the {agent} fails with the following error:
402+
403+
[source,console-result]
404+
----
405+
Error: the command is executed as root but the program files are not owned by the root user.
406+
----
407+
408+
*Impact* +
409+
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.
410+
411+
====
412+
299413
[discrete]
300414
[[new-features-8.17.1]]
301415
=== New features
@@ -320,7 +434,7 @@ The 8.17.1 release added the following new and notable features.
320434

321435
{fleet-server}::
322436
* Do not set the `unenrolled_at` attribute when the audit/unenroll API is called. {fleet-server-pull}4221[#4221] {agent-issue}6213[#6213]
323-
* 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]
437+
* 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]
324438

325439
{agent}::
326440
* 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]
@@ -357,12 +471,12 @@ impact to your application.
357471
[%collapsible]
358472
====
359473
*Details* +
360-
A known issue in the {agent} may prevent it from being targetted with an upgrade action for a future release.
474+
A known issue in the {agent} may prevent it from being targeted with an upgrade action for a future release.
361475
This may occur if the Defend integration is used and the agent is stopped on a running instance for too long.
362476
An agent may be stopped as part of an upgrade process.
363477
364478
*Impact* +
365-
A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occuring.
479+
A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occurring.
366480
367481
If you have agents that are affected, the workaround is as follows:
368482
[source,shell]

0 commit comments

Comments
 (0)