@@ -22,6 +22,7 @@ Contact us in the {im-forum}[discuss forum]. Your feedback is very valuable to u
22
22
* <<ingest-manager-app-crashes>>
23
23
* <<agent-enrollment-timeout>>
24
24
* <<es-apikey-failed>>
25
+ * <<process-not-root>>
25
26
* <<agent-hangs-while-unenrolling>>
26
27
27
28
**Frequently asked questions:**
@@ -156,6 +157,33 @@ property in the `kibana.yml` configuration file. For example:
156
157
xpack.encryptedSavedObjects.encryptionKey: "something_at_least_32_characters"
157
158
----
158
159
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
+
159
187
[discrete]
160
188
[[agent-hangs-while-unenrolling]]
161
189
== {agent} hangs while unenrolling
0 commit comments