elastic · rjernst · May 17, 2019 · May 16, 2019 · May 16, 2019 · May 16, 2019
diff --git a/docs/reference/commands/index.asciidoc b/docs/reference/commands/index.asciidoc
@@ -9,7 +9,6 @@ tasks from the command line:
 
 * <<certgen>>
 * <<certutil>>
-* <<migrate-tool>>
 * <<node-tool>>
 * <<saml-metadata>>
 * <<setup-passwords>>
@@ -21,7 +20,6 @@ tasks from the command line:
 
 include::certgen.asciidoc[]
 include::certutil.asciidoc[]
-include::migrate-tool.asciidoc[]
 include::node-tool.asciidoc[]
 include::saml-metadata.asciidoc[]
 include::setup-passwords.asciidoc[]

diff --git a/docs/reference/commands/migrate-tool.asciidoc b/docs/reference/commands/migrate-tool.asciidoc
diff --git a/docs/reference/migration/migrate_8_0/security.asciidoc b/docs/reference/migration/migrate_8_0/security.asciidoc
@@ -25,3 +25,11 @@ The `xpack.security.authz.store.roles.index.cache.max_size` and
 been removed. These settings have been redundant and deprecated
 since the 5.2 release of {es}.
 
+[float]
+[[migrate-tool-removed]]
+==== The `elasticsearch-migrate` tool has been removed
+
+The `elasticsearch-migrate` tool provided a way to convert file
+realm users and roles into the native realm. It has been deprecated
+since 7.2.0. Users and roles should now be created in the native
+realm directly.
diff --git a/x-pack/plugin/security/src/main/bin/elasticsearch-migrate b/x-pack/plugin/security/src/main/bin/elasticsearch-migrate
diff --git a/x-pack/plugin/security/src/main/bin/elasticsearch-migrate.bat b/x-pack/plugin/security/src/main/bin/elasticsearch-migrate.bat