@@ -24,6 +24,7 @@ Contact us in the {im-forum}[discuss forum]. Your feedback is very valuable to u
24
24
* <<ingest-manager-app-crashes>>
25
25
* <<agent-enrollment-timeout>>
26
26
* <<es-apikey-failed>>
27
+ * <<process-not-root>>
27
28
28
29
**Frequently asked questions:**
29
30
@@ -161,6 +162,33 @@ property in the `kibana.yml` configuration file. For example:
161
162
xpack.encryptedSavedObjects.encryptionKey: "something_at_least_32_characters"
162
163
----
163
164
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
+
164
192
[discrete]
165
193
[[enrolled-agent-not-showing-up]]
166
194
== Why doesn't my enrolled Agent show up in the {ingest-manager} app?
0 commit comments