Add known issue for Elastic Agent failing to enroll into Fleet

Author: vishaangelova

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

@@ -56,6 +56,29 @@ Review important information about the 8.17.7 release.
 
 Review important information about the  8.17.6 release.
 
+[discrete]
+[[known-issues-8.17.6]]
+=== Known issues
+
+[[known-issue-1800-8-17-6]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
+
 [discrete]
 [[enhancements-8.17.6]]
 === Enhancements
@@ -65,16 +88,36 @@ Review important information about the  8.17.6 release.
 
 // end 8.17.6 relnotes
 
-
-
-
 // begin 8.17.5 relnotes
 
 [[release-notes-8.17.5]]
 == {fleet} and {agent} 8.17.5
 
 Review important information about the  8.17.5 release.
 
+[discrete]
+[[known-issues-8.17.5]]
+=== Known issues
+
+[[known-issue-1800-8-17-5]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
+
 [discrete]
 [[enhancements-8.17.5]]
 === Enhancements
@@ -102,8 +145,6 @@ Review important information about the  8.17.5 release.
 
 // end 8.17.5 relnotes
 
-
-
 // begin 8.17.4 relnotes
 
 [[release-notes-8.17.4]]
@@ -138,6 +179,25 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m
 
 ====
 
+[[known-issue-1800-8-17-4]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
+
 [discrete]
 [[new-features-8.17.4]]
 === New features
@@ -209,6 +269,25 @@ In the 9.x releases, the option that appears in the UI for an upgrade across a m
 
 ====
 
+[[known-issue-1800-8-17-3]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
+
 [discrete]
 [[enhancements-8.17.3]]
 === Enhancements
@@ -240,6 +319,28 @@ Review important information about the {fleet} and {agent} 8.17.2 release.
 {fleet-server}::
 * Upgrade `golang.org/x/net` to v0.34.0 and `golang.org/x/crypto` to v0.32.0. {fleet-server-pull}4405[#4405]
 
+[discrete]
+[[known-issues-8.17.2]]
+=== Known issues
+
+[[known-issue-1800-8-17-2]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
 
 [discrete]
 [[enhancements-8.17.2]]
@@ -296,6 +397,25 @@ As a workaround, you can upgrade your deployment to 8.17.1 in which this issue h
 
 ====
 
+[[known-issue-1800-8-17-1]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
+
 [discrete]
 [[new-features-8.17.1]]
 === New features
@@ -320,7 +440,7 @@ The 8.17.1 release added the following new and notable features.
 
 {fleet-server}::
 * Do not set the `unenrolled_at` attribute when the audit/unenroll API is called. {fleet-server-pull}4221[#4221] {agent-issue}6213[#6213]
-* 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]
+* 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]
 
 {agent}::
 * 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 +477,12 @@ impact to your application.
 [%collapsible]
 ====
 *Details* +
-A known issue in the {agent} may prevent it from being targetted with an upgrade action for a future release.
+A known issue in the {agent} may prevent it from being targeted with an upgrade action for a future release.
 This may occur if the Defend integration is used and the agent is stopped on a running instance for too long.
 An agent may be stopped as part of an upgrade process.
 
 *Impact* +
-A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occuring.
+A bug fix is present in the 8.17.1 release of {fleet} that will prevent this from occurring.
 
 If you have agents that are affected, the workaround is as follows:
 [source,shell]
@@ -375,6 +495,25 @@ curl -XPOST -H 'Authorization: Bearer ${TOKEN}' -H 'x-elastic-product-origin:fle
 ----
 ====
 
+[[known-issue-1800-8-17-0]]
+.On Windows, {agent} is unable to enroll into {fleet} following the {agent}'s upgrade.
+[%collapsible]
+====
+
+*Details*
+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:
+
+[source,shell]
+----
+Error: the command is executed as root but the program files are not owned by the root user.
+For help, please see our troubleshooting guide at https://www.elastic.co/guide/en/fleet/8.17/fleet-troubleshooting.html
+----
+
+*Impact* +
+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.
+
+====
+
 [discrete]
 [[new-features-8.17.0]]
 === New features