Skip to content

Commit d23eb0d

Browse files
committed
[docs] Add troubleshooting topic about system user requirement for endpoint
1 parent 194fd9a commit d23eb0d

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
@@ -24,6 +24,7 @@ Contact us in the {im-forum}[discuss forum]. Your feedback is very valuable to u
2424
* <<ingest-manager-app-crashes>>
2525
* <<agent-enrollment-timeout>>
2626
* <<es-apikey-failed>>
27+
* <<process-not-root>>
2728

2829
**Frequently asked questions:**
2930

@@ -161,6 +162,33 @@ property in the `kibana.yml` configuration file. For example:
161162
xpack.encryptedSavedObjects.encryptionKey: "something_at_least_32_characters"
162163
----
163164

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

0 commit comments

Comments
 (0)