Deprecate the native realm migration tool (#42142)

The migrate tool was added when the native realm was created, to aid
users in converting from file realms that were per node, into the
cluster managed native realm. While this tool was useful at the time,
users should now be using the native realm directly. This commit
deprecates the tool, to be removed in a followup for 8.0.
This commit is contained in:
Ryan Ernst 2019-05-16 09:52:13 -04:00
parent 8681dd9cba
commit fa1d1d1f57
2 changed files with 3 additions and 0 deletions

View File

@ -3,6 +3,8 @@
[[migrate-tool]] [[migrate-tool]]
== elasticsearch-migrate == elasticsearch-migrate
deprecated:[7.2.0, "This tool is deprecated. Use the native realm directly."]
The `elasticsearch-migrate` command migrates existing file-based users and roles The `elasticsearch-migrate` command migrates existing file-based users and roles
to the native realm. From 5.0 onward, you should use the `native` realm to to the native realm. From 5.0 onward, you should use the `native` realm to
manage roles and local users. manage roles and local users.

View File

@ -133,6 +133,7 @@ public class ESNativeRealmMigrateTool extends LoggingAwareMultiCommand {
// Visible for testing // Visible for testing
@Override @Override
public void execute(Terminal terminal, OptionSet options, Environment env) throws Exception { public void execute(Terminal terminal, OptionSet options, Environment env) throws Exception {
terminal.println("Warning: The migrate tool is deprecated. Use the native realm directly instead of file realms.");
terminal.println("starting migration of users and roles..."); terminal.println("starting migration of users and roles...");
importUsers(terminal, env, options); importUsers(terminal, env, options);
importRoles(terminal, env, options); importRoles(terminal, env, options);