Skip to content

Commit 878a8e3

Browse files
committed
[docs] Add troubleshooting topic about system user requirement for endpoint
1 parent ce577d7 commit 878a8e3

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

docs/en/ingest-management/troubleshooting.asciidoc

+28
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ Contact us in the {im-forum}[discuss forum]. Your feedback is very valuable to u
2222
* <<ingest-manager-app-crashes>>
2323
* <<agent-enrollment-timeout>>
2424
* <<es-apikey-failed>>
25+
* <<process-not-root>>
2526
* <<agent-hangs-while-unenrolling>>
2627

2728
**Frequently asked questions:**
@@ -156,6 +157,33 @@ property in the `kibana.yml` configuration file. For example:
156157
xpack.encryptedSavedObjects.encryptionKey: "something_at_least_32_characters"
157158
----
158159

160+
[discrete]
161+
[[process-not-root]]
162+
== {agent} fails on Windows with `Agent process is not root/admin or validation failed` message
163+
164+
Make sure the user has administrator-level privileges.
165+
166+
If you're using the {elastic-endpoint} integration, also make sure you're
167+
running {agent} under the SYSTEM account.
168+
169+
To run {agent} under the SYSTEM account, you can:
170+
171+
. Download https://docs.microsoft.com/en-us/sysinternals/downloads/psexec[PsExec]
172+
and extract the contents to a folder, for example, `d:\tools`.
173+
. Open a command prompt as an Administrator (right-click the Command Prompt
174+
icon and select *Run As Administrator*).
175+
. From the command prompt, run {agent} under the SYSTEM account:
176+
+
177+
[source,sh]
178+
----
179+
d:\tools\psexec.exe -sid "C:\Program Files\Elastic-Agent\elastic-agent.exe" run
180+
----
181+
182+
183+
TIP: If you install {agent} as a service as described in
184+
<<elastic-agent-installation>>, the Agent runs under the SYSTEM account by
185+
default.
186+
159187
[discrete]
160188
[[agent-hangs-while-unenrolling]]
161189
== {agent} hangs while unenrolling

0 commit comments

Comments
 (0)