Improve agent uninstall docs to ensure correct directory (#796) (#797)

(cherry picked from commit 812e9b0) Co-authored-by: David Kilfoyle <[email protected]>
elastic · Jan 5, 2024 · 34effe2 · 34effe2
1 parent 7edc1a7
commit 34effe2
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 1 deletion.
diff --git a/docs/en/ingest-management/commands.asciidoc b/docs/en/ingest-management/commands.asciidoc
@@ -894,6 +894,18 @@ Permanently uninstall {agent} from the system.
 You must run this command as the root user (or Administrator on Windows)
 to remove files.
 
+[IMPORTANT] 
+==== 
+Be sure to run the `uninstall` command from the directory where {agent} is installed and not from the directory where you previously ran the `install` command.
+
+--
+
+include::{tab-widgets}/uninstall-widget.asciidoc[]
+
+--
+
+====
+
 [discrete]
 === Synopsis
 

diff --git a/docs/en/ingest-management/elastic-agent/uninstall-elastic-agent.asciidoc b/docs/en/ingest-management/elastic-agent/uninstall-elastic-agent.asciidoc
@@ -5,7 +5,9 @@
 == Uninstall on macOS, Linux, and Windows
 
 To uninstall {agent}, run the `uninstall` command from the directory where
-{agent} is running:
+{agent} is running.
+
+IMPORTANT: Be sure to run the `uninstall` command from the directory where {agent} is running, as shown in the example below, and not from the directory where you previously ran the `install` command. Running the command from the wrong directory can leave the agent in an inconsistent state.
 
 --
 include::{tab-widgets}/uninstall-widget.asciidoc[]